Openhands Agent MCP Server2025

🚀 OpenHands Agent MCP Server

خادم MCP ذكي ومتطور يوفر 8 أدوات متخصصة للذكاء الاصطناعي لتطوير المشاريع البرمجية.

⚡ الميزات الرئيسية

• 8 أدوات ذكية للتطوير والتحليل
• معمارية احترافية مع Controllers و Services منفصلة
• نظام SSE متقدم للتحديثات المباشرة
• معالجة أخطاء ذكية مع آلية إعادة المحاولة
• إدارة ذاكرة متطورة مع تخزين ذكي
• متوافق 100% مع بروتوكول MCP

🛠️ الأدوات المتاحة

🚀 التشغيل السريع

# تشغيل الخادم
node index.js

# أو استخدام npm
npm start

الخادم سيعمل على: http://localhost:3000

📡 نقاط النهاية الجديدة

🔍 معلومات النظام

GET /mcp/health        # حالة النظام والأداء
GET /mcp/tools/list    # قائمة الأدوات المتاحة
GET /mcp/sse          # Server-Sent Events

🧠 الأدوات الذكية

POST /mcp/idea        # توليد الأفكار
POST /mcp/structure   # إنشاء هياكل المشاريع
POST /mcp/tools       # اقتراح الأدوات
POST /mcp/ui          # بناء واجهات المستخدم
POST /mcp/tests       # كتابة الاختبارات
POST /mcp/dependency  # إدارة التبعيات

💾 إدارة الذاكرة

POST /mcp/memory/store    # تخزين البيانات
POST /mcp/memory/fetch    # استرجاع البيانات

🎯 أمثلة سريعة

توليد فكرة مشروع

curl -X POST http://localhost:3000/mcp/idea \
  -H "Content-Type: application/json" \
  -d '{"idea":"منصة تعليمية ذكية"}'

اقتراح الأدوات المناسبة

curl -X POST http://localhost:3000/mcp/tools \
  -H "Content-Type: application/json" \
  -d '{"projectType":"تطبيق ويب","requirements":["database","api"]}'

فحص حالة النظام

curl http://localhost:3000/mcp/health

⚙️ إعداد OpenHands

في ملف config.toml:

[mcp]
shttp_servers = [
  { url = "https://openhands-agent-mcp-server.steve6546.repl.co/mcp", api_key = null }
]
sse_servers = [
  "https://openhands-agent-mcp-server.steve6546.repl.co/mcp/sse"
]
stdio_servers = [
  { name = "fetch", command = "uvx", args = ["mcp-server-fetch"] }
]

🔄 بروتوكول MCP الجديد

الخادم يدعم الآن بروتوكول MCP الرسمي:

• POST /mcp/list_tools - قائمة الأدوات بصيغة MCP
• POST /mcp/call_tool - تنفيذ الأدوات بصيغة MCP
• JSON-RPC 2.0 متوافق مع OpenHands

🔧 إعدادات متقدمة

متغيرات البيئة

cp .env.example .env
# قم بتحديث .env حسب احتياجاتك

إعدادات مخصصة

• PORT: منفذ الخادم (افتراضي: 3000)
• MCP_API_KEY: مفتاح API اختياري
• MCP_TIMEOUT: مهلة العمليات (افتراضي: 10 ثوان)
• LOG_LEVEL: مستوى التسجيل (info, debug, error)

📊 مراقبة الأداء

معلومات النظام المباشرة

• استخدام الذاكرة والمعالج
• عدد الاتصالات النشطة
• حالة الأدوات والخدمات
• إحصائيات الأداء

Server-Sent Events

const eventSource = new EventSource('/mcp/sse');
eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('System Update:', data);
};

🛡️ الأمان والموثوقية

• معالجة أخطاء شاملة مع رسائل واضحة
• آلية إعادة المحاولة للعمليات الفاشلة
• نظام fallback ذكي عند الأعطال
• تسجيل شامل للأنشطة والأحداث
• حدود زمنية لمنع التعليق

🔗 الروابط المهمة

• المحلي: http://localhost:3000
• الخارجي: https://openhands-agent-mcp-server.steve6546.repl.co
• MCP Endpoint: https://openhands-agent-mcp-server.steve6546.repl.co/mcp
• المستودع: https://github.com/Steve6546/openhands-agent-mcp-server

🎉 الحالة

✅ جاهز للإنتاج - مختبر ومحسن ✅ متوافق مع MCP - يدعم جميع المعايير ✅ معمارية احترافية - قابل للصيانة والتطوير ✅ أداء عالي - مُحسن للسرعة والكفاءة

OpenHands Agent MCP Server - خادم ذكي متطور للمطورين المحترفين 🚀