Home
Login
googleapis/genai-toolbox

صندوق أدوات قاعدة بيانات MCP هو خادم MCP مفتوح المصدر لتبسيط تطوير أدوات قاعدة البيانات، وتوفير ميزات مثل تجمعات الاتصال والمصادقة.

Apache-2.0Go 1.4kgoogleapis Last Updated: 2025-06-12
https://github.com/googleapis/genai-toolbox

مشروع Genai-toolbox: مقدمة

نظرة عامة على المشروع

صندوق أدوات MCP لقواعد البيانات (MCP Toolbox for Databases) هو أداة خادم قواعد بيانات مفتوحة المصدر من Google، مصممة خصيصًا لتبسيط تطوير أدوات Gen AI. يمكّن هذا المشروع المطورين من بناء أدوات وكيل الذكاء الاصطناعي التي يمكنها الوصول إلى بيانات قاعدة البيانات بسهولة وسرعة وأمان أكبر.

عنوان المشروع: https://github.com/googleapis/genai-toolbox

الوظائف والميزات الأساسية

1. تبسيط عملية التطوير

  • تكامل سريع: ما عليك سوى أقل من 10 أسطر من التعليمات البرمجية لدمج الأداة في الوكيل
  • إعادة استخدام الأدوات: دعم إعادة استخدام الأدوات بين وكلاء أو أطر عمل متعددة
  • نشر مريح: تسهيل نشر إصدارات جديدة من الأدوات

2. تحسين الأداء

  • إدارة تجمع الاتصال: آلية تجمع اتصال مدمجة لتحسين أداء اتصال قاعدة البيانات
  • أفضل الممارسات: دمج أفضل الممارسات للوصول إلى قاعدة البيانات
  • معالجة فعالة: معالجة بيانات محسنة وتنفيذ الاستعلام

3. تعزيز الأمان

  • مصادقة متكاملة: توفير آلية وصول أكثر أمانًا للبيانات
  • اتصال آمن: ضمان أمان اتصال قاعدة البيانات
  • التحكم في الأذونات: دعم التحكم الدقيق في الوصول

4. إمكانية المراقبة الشاملة

  • مراقبة مدمجة: توفير مقاييس ووظائف تتبع جاهزة للاستخدام
  • دعم OpenTelemetry: دعم OpenTelemetry مدمج لتسهيل المراقبة وتصحيح الأخطاء
  • تتبع السلسلة الكاملة: دعم تتبع مسار الطلب الكامل

تصميم معماري

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

طريقة التثبيت

التثبيت الثنائي

# راجع صفحة الإصدار للحصول على إصدارات أخرى
export VERSION=0.4.0
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox

صورة الحاوية

# راجع صفحة الإصدار للحصول على إصدارات أخرى
export VERSION=0.4.0
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION

تجميع التعليمات البرمجية المصدر

go install github.com/googleapis/genai-toolbox@v0.4.0

طريقة الاستخدام

سير العمل الأساسي

  1. تكوين ملف tools.yaml: حدد أدواتك
  2. بدء تشغيل الخادم:
    ./toolbox --tools_file "tools.yaml"
    
  3. تحميل الأدوات إلى التطبيق: استخدم SDK المناسب

SDKs العملاء المدعومة

Core SDK

from toolbox_core import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = await client.load_toolset("toolset_name")

LangChain/LangGraph SDK

from toolbox_langchain import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = client.load_toolset()

LlamaIndex SDK

from toolbox_llamaindex import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = client.load_toolset()

وصف التكوين

تكوين مصدر البيانات

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-name:
    kind: postgres-sql
    source: my-pg-source
    description: Search for hotels based on name.
    parameters:
      - name: name
        type: string
        description: The name of the hotel.
    statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';

تكوين مجموعة الأدوات

toolsets:
  my_first_toolset:
    - my_first_tool
    - my_second_tool
  my_second_toolset:
    - my_second_tool
    - my_third_tool

التحكم في الإصدار

  • إصدار MAJOR: تغييرات API غير متوافقة
  • إصدار MINOR: إضافة ميزات متوافقة مع الإصدارات السابقة
  • إصدار PATCH: إصلاحات أخطاء متوافقة مع الإصدارات السابقة

سيناريوهات التطبيق

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

مزايا المشروع

  1. مفتوح المصدر ومجاني: مفتوح المصدر بالكامل، وتتم صيانته بواسطة Google
  2. ناضج ومستقر: يعتمد على أفضل ممارسات Google
  3. توافق النظام البيئي: يدعم أطر عمل الذكاء الاصطناعي الرئيسية
  4. سهولة التوسع: تكوين مرن وآليات توسيع
  5. مستوى المؤسسة: يوفر أمانًا وإمكانية مراقبة على مستوى المؤسسة

ملخص

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

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