{"title":"بناء عميل MCP مخصص","slug":"custom-client","category":"mcp","summary":"اتصل بخادم Synapse MCP من تطبيقك الخاص باستخدام MCP SDK.","audience":["human","llm"],"tags":["mcp","custom","sdk","development"],"difficulty":"advanced","updated":"2026-06-27","word_count":155,"read_minutes":1,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# بناء عميل MCP مخصص\n\nإذا كنت تبني تطبيق LLM خاصًا بك، يمكنك الاتصال بخادم Synapse\nMCP مباشرة باستخدام MCP SDK الرسمي. هذا يمنح تطبيقك الوصول إلى\nجميع أدوات Synapse الـ 79.\n\n## حزم SDK\n\n| اللغة | الحزمة |\n|----------|---------|\n| TypeScript/JavaScript | `@modelcontextprotocol/sdk` |\n| Python | `mcp` |\n\n## مثال TypeScript\n\n### تثبيت\n\n```bash\nnpm install @modelcontextprotocol/sdk\n```\n\n### الاتصال عبر stdio\n\n```typescript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\n\nconst transport = new StdioClientTransport({\n command: \"npx\",\n args: [\"-y\", \"synapse-mcp-api@latest\"],\n env: {\n SYNAPSE_MIND_KEY: process.env.SYNAPSE_MIND_KEY!,\n SYNAPSE_URL: \"https://synapse.schaefer.zone\",\n },\n});\n\nconst client = new Client(\n { name: \"my-app\", version: \"1.0.0\" },\n { capabilities: {} }\n);\n\nawait client.connect(transport);\n\n// سرد جميع الأدوات المتاحة\nconst { tools } = await client.listTools();\nconsole.log(`Available tools: ${tools.length}`);\nfor (const tool of tools) {\n console.log(`- ${tool.name}: ${tool.description}`);\n}\n\n// استدعِ أداة\nconst result = await client.callTool({\n name: \"memory_recall\",\n arguments: {},\n});\nconsole.log(result.content);\n\n// خزّن ذاكرة\nawait client.callTool({\n name: \"memory_store\",\n arguments: {\n category: \"fact\",\n key: \"custom_client_test\",\n content: \"Built a custom MCP client\",\n tags: [\"test\", \"mcp\"],\n priority: \"normal\",\n },\n});\n\nawait client.close();\n```\n\n### الاتصال عبر HTTP/SSE (بعيد)\n\n```typescript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\n\nconst transport = new SSEClientTransport(\n new URL(\"https://synapse-mcp.schaefer.zone/sse\"),\n {\n requestInit: {\n headers: {\n Authorization: `Bearer ${process.env.SYNAPSE_MIND_KEY}`,\n },\n },\n }\n);\n\nconst client = new Client(\n { name: \"my-app\", version: \"1.0.0\" },\n { capabilities: {} }\n);\n\nawait client.connect(transport);\n// ... استخدم كما هو مذكور أعلاه\n```\n\n## مثال Python\n\n### تثبيت\n\n```bash\npip install mcp\n```\n\n### الاتصال عبر stdio\n\n```python\nfrom mcp import ClientSession, StdioServerParameters\nfrom mcp.client.stdio import stdio_client\n\nserver_params = StdioServerParameters(\n command=\"npx\",\n args=[\"-y\", \"synapse-mcp-api@latest\"],\n env={\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n },\n)\n\nasync with stdio_client(server_params) as (read, write):\n async with ClientSession(read, write) as session:\n await session.initialize()\n\n # سرد الأدوات\n tools = await session.list_tools()\n print(f\"Available tools: {len(tools.tools)}\")\n\n # استدعِ أداة\n result = await session.call_tool(\"memory_recall\", {})\n print(result.content)\n\n # خزّن ذاكرة\n await session.call_tool(\"memory_store\", {\n \"category\": \"fact\",\n \"key\": \"python_client_test\",\n \"content\": \"Built a Python MCP client\",\n \"tags\": [\"test\", \"mcp\", \"python\"],\n \"priority\": \"normal\",\n })\n```\n\n## ملفات الأدوات\n\nعند الاتصال، يمكنك طلب ملف أداة محدد عبر\nترويسة `Mcp-Tool-Profile` (HTTP/SSE) أو متغير البيئة `MCP_PROFILE` (stdio):\n\n```typescript\n// stdio: عيّن متغير البيئة\nenv: {\n SYNAPSE_MIND_KEY: \"mk_...\",\n MCP_PROFILE: \"minimal\", // 8 أدوات بدلًا من 119\n}\n\n// HTTP/SSE: عيّن الترويسة\nrequestInit: {\n headers: {\n Authorization: \"Bearer mk_...\",\n \"Mcp-Tool-Profile\": \"minimal\",\n },\n}\n```\n\n## معالجة الأخطاء\n\n```typescript\ntry {\n const result = await client.callTool({ name: \"memory_recall\", arguments: {} });\n if (result.isError) {\n console.error(\"Tool error:\", result.content);\n } else {\n console.log(\"Success:\", result.content);\n }\n} catch (err) {\n console.error(\"MCP error:\", err);\n}\n```\n\n## حالات الاستخدام\n\n- **مساعدون ذكيون مخصصون** — ابنِ وكيلك الخاص بذاكرة دائمة\n- **أتمتة سير العمل** — اربط أدوات Synapse في سير عمل مخصص\n- **خطوط بيانات** — استخرج الذكريات، حوّل، حمّل في مكان آخر\n- **لوحات المراقبة** — اعرض إحصائيات الذاكرة، سجل الدردشة، المهام\n\n## الخطوات التالية\n\n- [مواصفات MCP](https://spec.modelcontextprotocol.io)\n- [مستودع Synapse MCP](https://gitlab.com/schaefer-services/synapse-mcp)\n- [نظرة عامة على الـ API](/docs/api/overview)\n","content_html":"

بناء عميل MCP مخصص

\n

إذا كنت تبني تطبيق LLM خاصًا بك، يمكنك الاتصال بخادم Synapse\nMCP مباشرة باستخدام MCP SDK الرسمي. هذا يمنح تطبيقك الوصول إلى\nجميع أدوات Synapse الـ 79.

\n

حزم SDK

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
اللغةالحزمة
TypeScript/JavaScript@modelcontextprotocol/sdk
Pythonmcp
\n

مثال TypeScript

\n

تثبيت

\n
npm install @modelcontextprotocol/sdk

الاتصال عبر stdio

\n
import { Client } from "@modelcontextprotocol/sdk/client/index.js";\nimport { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";\n\nconst transport = new StdioClientTransport({\n  command: "npx",\n  args: ["-y", "synapse-mcp-api@latest"],\n  env: {\n    SYNAPSE_MIND_KEY: process.env.SYNAPSE_MIND_KEY!,\n    SYNAPSE_URL: "https://synapse.schaefer.zone",\n  },\n});\n\nconst client = new Client(\n  { name: "my-app", version: "1.0.0" },\n  { capabilities: {} }\n);\n\nawait client.connect(transport);\n\n// سرد جميع الأدوات المتاحة\nconst { tools } = await client.listTools();\nconsole.log(`Available tools: ${tools.length}`);\nfor (const tool of tools) {\n  console.log(`- ${tool.name}: ${tool.description}`);\n}\n\n// استدعِ أداة\nconst result = await client.callTool({\n  name: "memory_recall",\n  arguments: {},\n});\nconsole.log(result.content);\n\n// خزّن ذاكرة\nawait client.callTool({\n  name: "memory_store",\n  arguments: {\n    category: "fact",\n    key: "custom_client_test",\n    content: "Built a custom MCP client",\n    tags: ["test", "mcp"],\n    priority: "normal",\n  },\n});\n\nawait client.close();

الاتصال عبر HTTP/SSE (بعيد)

\n
import { Client } from "@modelcontextprotocol/sdk/client/index.js";\nimport { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";\n\nconst transport = new SSEClientTransport(\n  new URL("https://synapse-mcp.schaefer.zone/sse"),\n  {\n    requestInit: {\n      headers: {\n        Authorization: `Bearer ${process.env.SYNAPSE_MIND_KEY}`,\n      },\n    },\n  }\n);\n\nconst client = new Client(\n  { name: "my-app", version: "1.0.0" },\n  { capabilities: {} }\n);\n\nawait client.connect(transport);\n// ... استخدم كما هو مذكور أعلاه

مثال Python

\n

تثبيت

\n
pip install mcp

الاتصال عبر stdio

\n
from mcp import ClientSession, StdioServerParameters\nfrom mcp.client.stdio import stdio_client\n\nserver_params = StdioServerParameters(\n    command="npx",\n    args=["-y", "synapse-mcp-api@latest"],\n    env={\n        "SYNAPSE_MIND_KEY": "mk_YOUR_KEY",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone",\n    },\n)\n\nasync with stdio_client(server_params) as (read, write):\n    async with ClientSession(read, write) as session:\n        await session.initialize()\n\n        # سرد الأدوات\n        tools = await session.list_tools()\n        print(f"Available tools: {len(tools.tools)}")\n\n        # استدعِ أداة\n        result = await session.call_tool("memory_recall", {})\n        print(result.content)\n\n        # خزّن ذاكرة\n        await session.call_tool("memory_store", {\n            "category": "fact",\n            "key": "python_client_test",\n            "content": "Built a Python MCP client",\n            "tags": ["test", "mcp", "python"],\n            "priority": "normal",\n        })

ملفات الأدوات

\n

عند الاتصال، يمكنك طلب ملف أداة محدد عبر\nترويسة Mcp-Tool-Profile (HTTP/SSE) أو متغير البيئة MCP_PROFILE (stdio):

\n
// stdio: عيّن متغير البيئة\nenv: {\n  SYNAPSE_MIND_KEY: "mk_...",\n  MCP_PROFILE: "minimal",  // 8 أدوات بدلًا من 119\n}\n\n// HTTP/SSE: عيّن الترويسة\nrequestInit: {\n  headers: {\n    Authorization: "Bearer mk_...",\n    "Mcp-Tool-Profile": "minimal",\n  },\n}

معالجة الأخطاء

\n
try {\n  const result = await client.callTool({ name: "memory_recall", arguments: {} });\n  if (result.isError) {\n    console.error("Tool error:", result.content);\n  } else {\n    console.log("Success:", result.content);\n  }\n} catch (err) {\n  console.error("MCP error:", err);\n}

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

\n\n

الخطوات التالية

\n\n","urls":{"html":"/docs/mcp/custom-client","text":"/docs/mcp/custom-client?format=text","json":"/docs/mcp/custom-client?format=json","llm":"/docs/mcp/custom-client?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}