MCP‐Server‐Tools

🔌 MCP Server Tools + IDE Integration

الإصدار: v0.1.2 | الحالة: قيد التطوير | Issue: #130

جدول المحتويات

• نظرة عامة
• أدوات MCP المتاحة
• إعداد MCP Server
• تكامل VS Code / Cursor
• أمثلة الاستخدام
• Issues ذات الصلة

---

نظرة عامة

يوفر AxiomID خادم MCP (Model Context Protocol) يكشف قدرات نظام الهوية كأدوات قابلة للاستدعاء من داخل بيئة التطوير (IDE) أو من وكلاء الذكاء الاصطناعي (AI Agents).

الهدف: تمكين المطورين ووكلاء الذكاء الاصطناعي من التفاعل مع AxiomID دون الحاجة لاستدعاءات API يدوية.

---

أدوات MCP المتاحة

axiom_resolve_did

يحلّ أي معرّف did:axiom ويعيد وثيقة DID الكاملة.

{
  "tool": "axiom_resolve_did",
  "params": {
    "did": "did:axiom:0xabc123..."
  }
}

axiom_check_gate

يتحقق من صلاحية وصول Soul Gate لمعرّف DID وعملية محددة.

{
  "tool": "axiom_check_gate",
  "params": {
    "did": "did:axiom:0xabc123...",
    "action": "transfer"
  }
}

axiom_get_trust_score

يجلب درجة الثقة (Trust Score) وتفاصيل المستوى (Tier) لمعرّف DID.

{
  "tool": "axiom_get_trust_score",
  "params": {
    "did": "did:axiom:0xabc123..."
  }
}

axiom_delegate

ينشئ صلاحية تفويض (delegation) محدودة النطاق.

{
  "tool": "axiom_delegate",
  "params": {
    "from_did": "did:axiom:0xabc123...",
    "to_did": "did:axiom:0xdef456...",
    "scope": ["read:profile", "verify:gate"]
  }
}

axiom_attest

يصدر شهادة (attestation) من داخل بيئة التطوير.

{
  "tool": "axiom_attest",
  "params": {
    "subject_did": "did:axiom:0xabc123...",
    "claim": "kyc_verified",
    "evidence": "https://provider.example/proof/123"
  }
}

---

إعداد MCP Server

التثبيت

# تثبيت الحزمة
npm install @axiomid/mcp-server

# أو باستخدام pnpm
pnpm add @axiomid/mcp-server

التشغيل

# تشغيل الخادم على stdio transport
axiomid-mcp --transport stdio

# أو على HTTP
axiomid-mcp --transport http --port 3100

إعداد المصادقة

AXIOM_API_KEY=your_api_key_here
AXIOM_NETWORK=mainnet  # أو testnet
AXIOM_DID_RESOLVER_URL=https://resolver.axiomid.dev

---

تكامل VS Code / Cursor

Issue ذات الصلة: #131 - VS Code / Cursor Extension

توفر إضافة VS Code/Cursor واجهة مستخدم بصرية لأدوات MCP:

المكوّن	الوصف
AxiomID Panel	لوحة جانبية تعرض وثيقة DID لأي معرّف
Gate Checker	أمر مدمج للتحقق من صلاحية Soul Gate
Trust Score Badge	شارة في شريط الحالة تعرض مستوى الثقة
Delegation Wizard	معالج لإنشاء صلاحيات التفويض
Attestation Command	إصدار شهادات مباشرة من المحرر

الإعداد في .vscode/settings.json

{
  "axiomid.mcpServer": "stdio",
  "axiomid.apiKey": "${env:AXIOM_API_KEY}",
  "axiomid.network": "mainnet"
}

---

أمثلة الاستخدام

من وكيل الذكاء الاصطناعي (AI Agent)

import { MCPClient } from '@modelcontextprotocol/sdk';

const client = new MCPClient();
await client.connect('stdio', { command: 'axiomid-mcp' });

// حل DID
const didDoc = await client.callTool('axiom_resolve_did', {
  did: 'did:axiom:0xabc123...'
});

// التحقق من Soul Gate
const gateAccess = await client.callTool('axiom_check_gate', {
  did: 'did:axiom:0xabc123...',
  action: 'transfer'
});

---

Issues ذات الصلة

Issue	العنوان	الحالة
#130	MCP Server Tools + IDE Integration	🟢 Open
#131	VS Code / Cursor Extension	🟢 Open

---

صفحة موثقة تلقائياً ضمن Milestone v0.1.2 – MCP Server Tools + IDE Integration