Skip to main content
هذا مثال على كيفية بناء تطبيق قائم على الوكلاء باستخدام البيانات المخزنة في ClickHouse. ويستخدم ClickHouse MCP server للاستعلام عن البيانات من ClickHouse وإنشاء مخططات بيانية استنادًا إليها. يُستخدم CopilotKit لبناء واجهة المستخدم وتوفير واجهة دردشة للمستخدم.
مثال على الشيفرةيمكن العثور على الشيفرة الخاصة بهذا المثال في مستودع examples.

​
المتطلبات الأساسية

  • Node.js >= 20.14.0
  • uv >= 0.1.0

​
تثبيت التبعيات

استنسخ المشروع محليًا: git clone https://github.com/ClickHouse/examples ثم انتقل إلى المجلد ai/mcp/copilotkit. يمكنك تخطي هذا القسم وتشغيل البرنامج النصي ./install.sh لتثبيت التبعيات. وإذا كنت تريد تثبيت التبعيات يدويًا، فاتبع الإرشادات أدناه.

​
تثبيت التبعيات يدويًا

  1. ثبّت التبعيات:
شغّل npm install لتثبيت تبعيات Node.js.
  1. ثبّت mcp-clickhouse:
أنشئ مجلدًا جديدًا باسم external ثم استنسخ إليه مستودع mcp-clickhouse.
ثبّت تبعيات بايثون وأضف أداة fastmcp لسطر الأوامر.

​
إعداد التطبيق

انسخ ملف env.example إلى .env ثم عدِّله لإضافة ANTHROPIC_API_KEY الخاص بك.

​
استخدم LLM الخاص بك

إذا كنت تفضّل استخدام موفّر LLM آخر غير Anthropic، يمكنك تعديل بيئة تشغيل Copilotkit لاستخدام مهايئ LLM مختلف. هنا ستجد قائمة بالموفّرين المدعومين.

​
استخدم عنقود ClickHouse الخاص بك

افتراضيًا، جرى إعداد المثال للاتصال بـ عنقود ClickHouse التجريبي. يمكنك أيضًا استخدام عنقود ClickHouse الخاص بك عبر تعيين متغيرات البيئة التالية:
  • CLICKHOUSE_HOST
  • CLICKHOUSE_PORT
  • CLICKHOUSE_USER
  • CLICKHOUSE_PASSWORD
  • CLICKHOUSE_SECURE

​
شغّل التطبيق

شغّل npm run dev لبدء خادم التطوير. يمكنك اختبار الوكيل باستخدام موجّه مثل:
“أرني تطور الأسعار في Manchester خلال السنوات العشر الماضية.”
افتح http://localhost:3000 في متصفحك لمشاهدة النتيجة.
آخر تعديل في ٣ يوليو ٢٠٢٦