العودة إلى التحديثات
New releaseSep 11, 2026

scopeblind-gateway v0.13.1

بوابة سياسات Cedar المغلقة عند الفشل مع إيصالات موقّعة لاستدعاءات أدوات وكيل الذكاء الاصطناعي. npx protect-mcp

مشاركة

protect-mcp

فرض السياسات محليًا وإيصالات قرارات موقّعة لاستدعاءات أدوات وكيل الذكاء الاصطناعي.

npm version Monthly npm downloads Node.js compatibility Package checks MIT license

صفحة المطوّر · البدء السريع · إعداد الوكيل · حزم السياسات · سجل نموذجي · التكاملات · التوثيق · المساهمة

ضع البوابة بين عميل MCP وخادم أدواته، أو استخدم خطافاتها في وكيل برمجي. راجع سياسة Cedar، وفعّل الفرض، واحتفظ بسجل موقّع للقرارات. لا يحتاج التقييم والتحقق المحليان إلى حساب ScopeBlind ولا يرسلان أي بيانات قياس عن بُعد للقرارات.

  • الفرض عند حدود الأداة. يرفض Cedar عند غياب السياسات أو أخطاء المحرك أو أخطاء التقييم في وضع الفشل المغلق. وضع الظل هو الافتراضي في غلاف MCP: استخدم --enforce عندما تكون مستعدًا للحظر.
  • تحقق مما تم توقيعه. تتضمن إيصالات Ed25519 القرار وبصمة السياسة. يتحقق @veritasacta/verify من البايتات مقابل المفتاح العام الذي تثق به.
  • ابدأ بالأدوات الموجودة. استخدم MCP stdio أو بوابة HTTP أو خطافات الوكيل البرمجي. التعاون المستضاف الاختياري له أذوناته وتدفقات بياناته الخاصة.

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

شاهد النتيجة

تشغيل محلي حقيقي: قيّم استدعاءين مقترحين، ووقّع القرارين، وتحقق من الإيصالين، ثم غيّر قرارًا موقّعًا وتحقق منه مرة أخرى.

ملخص نتيجة من خمس خطوات: يُسمح بعملية قراءة، ويُرفض دفع قسري مقترح، ويُوقّع القراران، وتتحقق إيصالاتهما، ويفشل رفض معدّل في التحقق من التوقيع. لا تُنفّذ أي أداة مقترحة.

شاهد العرض التوضيحي الذي يستغرق 14 ثانية

ملخص نتيجة متحرك للخطوات الخمس نفسها، مبني على مخرجات CLI الملتقطة.

العرض النصي وإعادة الإنتاج · النتائج الملتقطة

جرّبه بدون وكيل

استخدم Node.js 22 وnpm في دليل جديد. ثبّت البوابة والمدقق المثبّتين:

mkdir protect-mcp-demo
cd protect-mcp-demo
npm init -y
npm install --save-exact [email protected] @veritasacta/[email protected]

يقيّم هذا المثال استدعاءين مقترحين ويوقّع قراريهما. وهو لا ينفّذ أيًا من الأداتين ولا يشغّل git push. كل ما يأتي بعد التثبيت محلي.

# Create a starter policy and a private signing key.
npx --no-install protect-mcp init --starter

# A normal read is allowed; a force-push to main is denied (exit 2).
npx --no-install protect-mcp evaluate --policy ./protect.cedar --tool Read --input '{"path":"README.md"}'
npx --no-install protect-mcp evaluate --policy ./protect.cedar --tool Bash --input '{"command":"git push --force origin main"}' || test "$?" -eq 2

# Evaluate again at signing time and record both decisions, in order.
npx --no-install protect-mcp sign --cedar builtin:starter --tool Read --input '{"path":"README.md"}' --key ./protect-mcp.key --receipts ./receipts
npx --no-install protect-mcp sign --cedar builtin:starter --tool Bash --input '{"command":"git push --force origin main"}' --key ./protect-mcp.key --receipts ./receipts

# Take only the public key from the key you generated, not from the receipt.
PROTECT_MCP_PUBLIC_KEY=$(node -p 'JSON.parse(require("fs").readFileSync("protect-mcp.key", "utf8")).publicKey')
npx --no-install verify --replay-chain ./receipts/receipts.jsonl --key "$PROTECT_MCP_PUBLIC_KEY" --json

# Change the signed deny to allow. The original receipt log stays intact.
node -e 'const fs=require("fs");const r=JSON.parse(fs.readFileSync("receipts/receipts.jsonl","utf8").trim().split("\n")[1]);r.payload.decision="allow";fs.writeFileSync("tampered.json",JSON.stringify(r))'
npx --no-install verify tampered.json --key "$PROTECT_MCP_PUBLIC_KEY" --json || test "$?" -eq 1

المتوقع: allow، ثم deny؛ يتم التحقق من توقيعي الإيصال الأصليين ورابطهما؛ ويُبلّغ الإيصال المعدّل عن invalid_signature. أبقِ protect-mcp.key خاصًا. للتحقق من سجل شخص آخر، احصل على مفتاحه العام المتوقع عبر قناة موثوقة مستقلة.

رموز خروج المدقّق هي 0: صالح، 1: غير صالح، 2: لم يتم التحقق/خطأ. النتيجة غير الصالحة ليست بالضرورة تلاعبًا: فالمفتاح المتوقع الخاطئ قد يُفشل التحقق أيضًا. تتحقق إعادة تشغيل السلسلة من الروابط المقدَّمة؛ ولا تثبت أنك تلقيت السجل الكامل.

يشغّل CI هذا المثال نفسه مقابل المرشح المحزوم والمدقّق المنشور المثبّت. راجع التحقق والإصدارات.

اربط وكيلك

اختر التكامل الذي يطابق مضيفك والتغطية التي تحتاجها. تثبيت مهارات الإرشاد لا يفعّل الإنفاذ. يفحص doctor التكوين المحلي؛ أكّد المسار المختار باستدعاء حقيقي مسموح وآخر محظور.

بالنسبة لإضافة Claude Code، أولًا جهّز البوابة المحلية وابدأها، ثم ثبّتها في مشروعك (Claude Code 2.1.295 أو أحدث):

claude plugin install protect-mcp --marketplace ScopeBlind/scopeblind-gateway --scope project

تقوم الإضافة بحظر استدعاءات الأدوات الموجّهة أثناء عدم توفّر بوابتها. اختر الإضافة أو خطافات المشروع المستقلة، حتى لا يُسجَّل الاستدعاء نفسه مرتين.

حالة الاستخدامابدأ من هنا
تغليف خادم MCP موجودإعداد MCP وسير العمل من الظل إلى الإنفاذ
إضافة الإنفاذ لـ Claude Codeإعداد الإضافة والبوابة المحلية
خطافات مشروع Claude Codeإعداد الخطاف
معاينة مشروع Cursorالإعداد الصريح وتعيين الأدوات وفحوصات المضيف
معاينة مساعد ChatGPT / Codexإرشادات الإعداد وعرض تحقّق غير ضار، بدون خطافات
إضافة إرشادات دليل Claude الموجودةمصدر الإضافة المنشور، منفصل عن الإنفاذ
استدعاء مُقيِّم السياسة كأدوات MCPالبوابة كخادم MCP
استضافة بوابة HTTPملاحظات نشر HTTP

الفئات