نظرة عامة

mcporter (MCPorter 🧳) هو مجموعة أدوات مفتوحة المصدر تشمل بيئة تشغيل TypeScript، واجهة سطر الأوامر (CLI)، وأدوات توليد الأكواد لنظام بروتوكول سياق النموذج (MCP). يتيح للمطورين ووكلاء الذكاء الاصطناعي اكتشاف خوادم MCP المُهيَّأة، واستدعاء الأدوات مباشرةً، وبناء مهام آلية في TypeScript، وتوليد واجهات سطر أوامر (CLIs) لأغراض محددة من أي نقطة نهاية لـ MCP.

مبني لدعم توجيهات Anthropic حول "تنفيذ التعليمات البرمجية باستخدام MCP"، ويتخلص من التعليمات البرمجية الروتينية المفرطة ومن تضخم نافذة السياق من خلال تمكين وكلاء الذكاء الاصطناعي من استدعاء الأدوات عبر ثنائيات CLI خفيفة الوزن بدلاً من تحميل هياكل JSON ضخمة.

الإصدار الأحدث: 0.8.2 (مارس 2026). مرخص بترخيص MIT.

الميزات

اكتشاف بلا تهيئة: يكتشف خوادم MCP تلقائيًا من ~/.mcporter/mcporter.json، وتكوينات المشروع، والتكامل مع Claude، وCursor، وCodex، وVS Code، وWindsurf، وOpenCode.

استدعاء الأدوات عبر CLI أولاً: تشغيل الأدوات بتركيبة طبيعية (mcporter call linear.create_comment ...) أو بطريقة استدعاء دالة — دون الحاجة لمعرفة الهيكل (schema).

توليد CLI بأمر واحد: mcporter generate-cli يقوم بإنشاء واجهات سطر أوامر (CLIs) مستقلة ومتكاملة (باستخدام Bun/Node) من أي خادم MCP لتسهيل المشاركة واستخدام الوكلاء.

واجهة برمجة TypeScript مكتوبة الأنواع: mcporter emit-ts يقوم بتوليد واجهات .d.ts أو أغلفة عميل كاملة مع كتابة قوية للأنواع، وإعدادات افتراضية، وتحقق.

بيئة تشغيل قابلة للتأليف: createRuntime() + createServerProxy() مع تجميع الاتصالات، وتخزين OAuth مؤقت، ومراقبة السجلات (log tailing)، ودعم وسائط نقل HTTP/SSE/stdio.

وضع المهام المؤقتة ووضع الخدمة الخلفية (Daemon): الاتصال بأي نقطة نهاية لـ MCP فوراً؛ الحفاظ على الخوادم ذات الحالة (مثل chrome-devtools) نشطة باستخدام أوامر الخدمة الخلفية.

ملائم لوكلاء الذكاء الاصطناعي: يقلل من تضخم السياق — يستدعي الوكلاء ثنائية CLI صغيرة بدلاً من تضمين هياكل MCP كاملة.

أدوات قوية: تصحيح تلقائي، تنسيق غني للإخراج (text(), json())، إدارة التكوين، ومساعدات التصحيح.

حالات الاستخدام

تكامل أدوات وكلاء الذكاء الاصطناعي: السماح لـ Claude/Cursor باستدعاء خوادم MCP معقدة عبر واجهات CLI المُولَّدة دون توسيع نافذة السياق بشكل مفرط.

برمجة المهام الآلية السريعة: بناء سير عمل بـ TypeScript يجمع بين عدة أدوات MCP مع ضمان كامل لنوع البيانات.

مشاركة الأدوات: توليد وتوزيع واجهات CLI لأغراض محددة (مثل linear-comment) للفرق أو للاستخدام العام.

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

تقليل التضخم في MCP: استبدال تحميل هياكل ضخمة في المحررات/الوكلاء باستدعاءات CLI خفيفة الوزن.

التثبيت والبدء السريع

التشغيل فورًا (بدون تثبيت)

npx mcporter list
npx mcporter list linear --schema

تثبيت عالمي

npm install -g mcporter
# أو باستخدام Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter

أمثلة على الاستدعاءات

# تركيب النقطتين
mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'

# تركيب استدعاء الدالة
mcporter call 'linear.create_comment(issueId: "ENG-123", body: "Looks good!")'

إنشاء واجهة سطر أوامر

mcporter generate-cli --command https://mcp.context7.com/mcp

### استخدام TypeScript
```ts
import { createRuntime } from "mcporter";
const runtime = await createRuntime();
const result = await runtime.callTool("context7", "resolve-library-id", {
  args: { libraryName: "react" }
});
console.log(result.text());
await runtime.close();

وثائق كاملة، مرجع واجهة سطر الأوامر، وأمثلة في المستودع.

لماذا mcporter؟

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

روابط

• GitHub: steipete/mcporter
• الموقع الإلكتروني: mcporter.dev
• مرجع واجهة سطر الأوامر والوثائق: github.com/steipete/mcporter/tree/main/docs

رفيق مثالي لأي سير عمل للذكاء الاصطناعي مدعوم بـ MCP.