صندوق أدوات قاعدة بيانات MCP هو خادم MCP مفتوح المصدر لتبسيط تطوير أدوات قاعدة البيانات، وتوفير ميزات مثل تجمعات الاتصال والمصادقة.
مشروع 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
طريقة الاستخدام
سير العمل الأساسي
- تكوين ملف tools.yaml: حدد أدواتك
- بدء تشغيل الخادم:
./toolbox --tools_file "tools.yaml"
- تحميل الأدوات إلى التطبيق: استخدم 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: إصلاحات أخطاء متوافقة مع الإصدارات السابقة
سيناريوهات التطبيق
- تطوير وكيل الذكاء الاصطناعي: بناء أدوات الوصول إلى قاعدة البيانات لوكلاء الذكاء الاصطناعي
- تكامل البيانات: تبسيط تكامل التطبيقات مع قواعد البيانات
- إدارة الأدوات: إدارة وتوزيع أدوات قاعدة البيانات مركزيًا
- دعم الأطر المتعددة: مشاركة الأدوات بين أطر عمل الذكاء الاصطناعي المختلفة
مزايا المشروع
- مفتوح المصدر ومجاني: مفتوح المصدر بالكامل، وتتم صيانته بواسطة Google
- ناضج ومستقر: يعتمد على أفضل ممارسات Google
- توافق النظام البيئي: يدعم أطر عمل الذكاء الاصطناعي الرئيسية
- سهولة التوسع: تكوين مرن وآليات توسيع
- مستوى المؤسسة: يوفر أمانًا وإمكانية مراقبة على مستوى المؤسسة
ملخص
صندوق أدوات MCP لقواعد البيانات هو مشروع مفتوح المصدر قوي وسهل الاستخدام، مصمم خصيصًا لتلبية احتياجات تكامل قاعدة البيانات لتطبيقات الذكاء الاصطناعي الحديثة. فهو يساعد المطورين على بناء أدوات قاعدة بيانات الذكاء الاصطناعي موثوقة بسرعة من خلال توفير تجربة تطوير مبسطة وأداء محسن وأمان محسّن وإمكانية مراقبة شاملة.
سواء كنت تقوم بتطوير وكيل ذكاء اصطناعي، أو بناء تطبيق يعتمد على البيانات، أو تحتاج إلى مشاركة أدوات قاعدة البيانات بين أطر عمل متعددة، فإن صندوق أدوات MCP لقواعد البيانات هو حل يستحق الدراسة. تصميمه المعماري المرن ودعم SDK الغني يجعله قادرًا على التكيف بشكل جيد مع سيناريوهات ومتطلبات التطوير المختلفة.