دليل المبتدئين لأدوات Google MCP لقواعد البيانات

مقدمة إلى صندوق أدوات MCP

صندوق أدوات MCP هو أداة مجانية من جوجل تساعد تطبيقات الذكاء الاصطناعي الخاصة بك على التواصل مع قواعد بياناتك. فكر في الأمر كمترجم خاص. يمكن لذكائك الاصطناعي طلب المعلومات بطريقة بسيطة، ويقوم صندوق أدوات MCP بترجمة هذا الطلب إلى اللغة التي تفهمها قاعدة بياناتك، مثل SQL. ويستخدم شيئًا يسمى بروتوكول سياق النموذج (MCP)، وهو مجرد مجموعة قياسية من القواعد لهذا النوع من الاتصال.

لماذا يجب عليك استخدام صندوق أدوات MCP

صندوق أدوات MCP ليس مجرد مترجم؛ بل يجعل بناء تطبيقات الذكاء الاصطناعي الخاصة بك أسهل وأفضل بكثير.

صندوق أدوات MCP يجعل التعليمات البرمجية الخاصة بك أبسط

بدون صندوق أدوات MCP، يتعين عليك كتابة الكثير من التعليمات البرمجية فقط لربط ذكائك الاصطناعي بقاعدة بياناتك. تحتاج إلى تعليمات برمجية للاتصال، وللتعامل مع الأخطاء، وللأمان. مع صندوق أدوات MCP، ما عليك سوى تحديد إجراءات قاعدة البيانات الخاصة بك في ملف نصي بسيط يسمى tools.yaml. يخبر هذا الملف صندوق الأدوات بالإجراءات الممكنة، ويتعامل صندوق الأدوات مع كل العمل الشاق لربط قاعدة البيانات بشكل آمن.

صندوق أدوات MCP يحسن السرعة والأمان

صندوق أدوات MCP مصمم ليكون سريعًا. يستخدم تقنية تسمى "تجميع الاتصالات" (connection pooling)، مما يعني أنه يحافظ على اتصالات قاعدة البيانات مفتوحة ويعيد استخدامها. وهذا يوفر الكثير من الوقت مقارنة بفتح اتصال جديد لكل طلب واحد. كما أنه آمن لأنك تدير جميع وصول قاعدة البيانات في مكان مركزي واحد، مما يقلل من مخاطر الأخطاء.

صندوق أدوات MCP يوضح لك ما يحدث

عندما يكون لديك ذكاء اصطناعي، وصندوق أدوات، وقاعدة بيانات تعمل جميعها معًا، قد يكون من الصعب رؤية ما يجري. يحتوي صندوق أدوات MCP على دعم مدمج لـ "الرصد" (observability)، مما يعني أنه يمكنه إنشاء سجلات وتتبعات لكل إجراء. وهذا يساعدك على فهم ما تفعله أدواتك، والعثور على أي مشاكل، ومعرفة كيفية جعل الأمور أسرع.

كيف يتناسب صندوق أدوات MCP مع مشروعك

يقع صندوق أدوات MCP في منتصف تطبيقك. يبدو التدفق كالتالي:

1. تطبيق الذكاء الاصطناعي الخاص بك: هذا هو المكان الذي يعيش فيه نموذج الذكاء الاصطناعي الخاص بك. يقرر أنه يحتاج إلى بعض المعلومات من قاعدة البيانات للإجابة على سؤال.
2. صندوق أدوات MCP: يرسل تطبيق الذكاء الاصطناعي طلبًا إلى صندوق أدوات MCP. ينظر صندوق الأدوات إلى ملف tools.yaml الخاص به، ويجد الأداة المناسبة للمهمة، ويقوم بتشغيل الأمر المقابل على قاعدة بياناتك.
3. قاعدة بياناتك: تقوم قاعدة البيانات بتشغيل الأمر وإرسال البيانات مرة أخرى إلى صندوق أدوات MCP، الذي يمررها بعد ذلك إلى ذكائك الاصطناعي.

يعني هذا الإعداد أن تطبيق الذكاء الاصطناعي الرئيسي الخاص بك لا يحتاج إلى معرفة التفاصيل المعقدة لكيفية عمل قاعدة بياناتك. يمكنك حتى تغيير أدواتك أو قاعدة بياناتك دون الحاجة إلى إعادة كتابة التعليمات البرمجية لتطبيق الذكاء الاصطناعي الخاص بك.

دليل خطوة بخطوة لاستخدام صندوق أدوات MCP

دعنا ننتقل إلى كيفية تشغيل صندوق أدوات MCP على جهاز الكمبيوتر الخاص بك.

الخطوة 1: إعداد قاعدة البيانات الخاصة بك لصندوق أدوات MCP

أولاً، تحتاج إلى قاعدة بيانات. تستخدم هذه الخطوات PostgreSQL كمثال. ستقوم بإنشاء مستخدم خاص وقاعدة بيانات ليستخدمها صندوق الأدوات.

اتصل بخادم PostgreSQL الخاص بك.

قم بتشغيل أوامر SQL هذه لإنشاء مستخدم باسم toolbox_user وقاعدة بيانات باسم toolbox_db:

CREATE USER toolbox_user WITH PASSWORD 'my-password';
CREATE DATABASE toolbox_db;
GRANT ALL PRIVILEGES ON DATABASE toolbox_db TO toolbox_user;

أنشئ جدولاً نموذجياً، مثل جدول hotels، حتى يكون لأدواتك بعض البيانات للعمل بها.

الخطوة 2: تثبيت وتكوين صندوق أدوات MCP

بعد ذلك، ستقوم بإعداد صندوق الأدوات نفسه.

قم بتنزيل برنامج صندوق أدوات MCP من صفحة الإصدار الرسمية على GitHub. تأكد من الحصول على الإصدار الصحيح لجهاز الكمبيوتر الخاص بك (مثل Windows أو Mac أو Linux).

أنشئ ملفًا جديدًا باسم tools.yaml. هذا الملف هو المكان الذي ستحدد فيه جميع الإجراءات التي يمكن أن يتخذها الذكاء الاصطناعي الخاص بك. إليك مثال بسيط:

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

tools:
  search-hotels-by-location:
    kind: postgres-sql
    source: my-pg-source
    description: Finds hotels in a specific city.
    parameters:
      - name: location
        type: string
        description: The city to search for hotels in.
    statement: SELECT * FROM hotels WHERE location = $1;

الخطوة 3: تشغيل خادم صندوق أدوات MCP

الآن يمكنك بدء تشغيل صندوق الأدوات. افتح الطرفية الخاصة بك، وانتقل إلى المجلد الذي قمت بتنزيل صندوق الأدوات فيه، ثم قم بتشغيل هذا الأمر:

./toolbox --tools-file "tools.yaml"

سيبدأ الخادم بتحميل الأدوات التي قمت بتعريفها.

كيفية الاختبار باستخدام مفتش صندوق أدوات MCP

يأتي صندوق أدوات MCP مع أداة اختبار تسمى Inspector (المفتش). هذه صفحة ويب تتيح لك تجربة أدواتك دون الحاجة إلى كتابة أي تعليمات برمجية.

1. قم بتشغيل المفتش من الطرفية الخاصة بك باستخدام هذا الأمر: npx @modelcontextprotocol/inspector.
2. افتح عنوان الويب الذي يعطيك إياه في متصفحك.
3. اطلب منه الاتصال بخادم صندوق أدوات MCP قيد التشغيل (عادةً على http://127.0.0.1:5000/mcp/sse).
4. بمجرد الاتصال، يمكنك رؤية قائمة بأدواتك، وملء معاييرها، وتشغيلها لمعرفة ما إذا كانت تعمل بشكل صحيح.

كيفية ربط تطبيقك بصندوق أدوات MCP

بعد الاختبار، يمكنك ربط تطبيق الذكاء الاصطناعي الحقيقي الخاص بك. يحتوي صندوق أدوات MCP على حزم تطوير البرمجيات (SDKs) لتسهيل ذلك. إليك مثال بسيط بلغة بايثون:

ثبت حزمة تطوير بايثون (Python SDK): pip install toolbox-core.

استخدم هذا الكود للاتصال بصندوق الأدوات وتحميل أدواتك:

from toolbox_core import ToolboxClient
import asyncio

async def main():
    async with ToolboxClient("http://127.0.0.1:5000") as client:
        tools = await client.load_toolset()
        # The 'tools' variable now holds your database tools
        # and you can give them to your AI model.
        print("Tools loaded successfully!")

asyncio.run(main())

يتصل هذا الكود بخادم صندوق الأدوات ويقوم بتنزيل الأدوات التي قمت بتعريفها. يمكنك بعد ذلك إعطاء هذه الأدوات لوكيل الذكاء الاصطناعي الخاص بك، وسيكون قادرًا على استخدامها للتفاعل مع قاعدة بياناتك.

أفكار أخيرة حول صندوق أدوات MCP

صندوق أدوات MCP من جوجل هو أداة رائعة لأي مطور يعمل مع الذكاء الاصطناعي وقواعد البيانات. إنه يبسط التعليمات البرمجية الخاصة بك، ويجعل تطبيقك أسرع وأكثر أمانًا، ويمنحك الرؤية التي تحتاجها لفهم كيفية عمل كل شيء. باتباع الخطوات الواردة في هذا الدليل، يمكنك البدء في استخدام صندوق أدوات MCP لبناء تطبيقات ذكاء اصطناعي أكثر قوة وتعتمد على البيانات.