{"title":"Budowa niestandardowego klienta MCP","slug":"custom-client","category":"mcp","summary":"Połączenie z serwerem Synapse MCP z własnej aplikacji przy użyciu SDK MCP.","audience":["human","llm"],"tags":["mcp","custom","sdk","development"],"difficulty":"advanced","updated":"2026-06-27","word_count":152,"read_minutes":1,"lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Budowa niestandardowego klienta MCP\n\nJeśli buduje się własną aplikację LLM, można połączyć się z serwerem Synapse MCP\nbezpośrednio, używając oficjalnego SDK MCP. Daje to aplikacji dostęp do wszystkich\n79 narzędzi Synapse.\n\n## SDK\n\n| Język | Pakiet |\n|----------|---------|\n| TypeScript/JavaScript | `@modelcontextprotocol/sdk` |\n| Python | `mcp` |\n\n## Przykład w TypeScript\n\n### Instalacja\n\n```bash\nnpm install @modelcontextprotocol/sdk\n```\n\n### Połączenie przez 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// Lista wszystkich dostępnych narzędzi\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// Wywołanie narzędzia\nconst result = await client.callTool({\n name: \"memory_recall\",\n arguments: {},\n});\nconsole.log(result.content);\n\n// Zapis wspomnienia\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### Połączenie przez HTTP/SSE (zdalne)\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// ... użycie jak wyżej\n```\n\n## Przykład w Pythonie\n\n### Instalacja\n\n```bash\npip install mcp\n```\n\n### Połączenie przez 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 # Lista narzędzi\n tools = await session.list_tools()\n print(f\"Available tools: {len(tools.tools)}\")\n\n # Wywołanie narzędzia\n result = await session.call_tool(\"memory_recall\", {})\n print(result.content)\n\n # Zapis wspomnienia\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## Profile narzędzi\n\nPodczas łączenia można zażądać konkretnego profilu narzędzi przez nagłówek\n`Mcp-Tool-Profile` (HTTP/SSE) lub zmienną środowiskową `MCP_PROFILE` (stdio):\n\n```typescript\n// stdio: ustawienie zmiennej środowiskowej\nenv: {\n SYNAPSE_MIND_KEY: \"mk_...\",\n MCP_PROFILE: \"minimal\", // 8 narzędzi zamiast 119\n}\n\n// HTTP/SSE: ustawienie nagłówka\nrequestInit: {\n headers: {\n Authorization: \"Bearer mk_...\",\n \"Mcp-Tool-Profile\": \"minimal\",\n },\n}\n```\n\n## Obsługa błędów\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## Przypadki użycia\n\n- **Niestandardowi asystenci AI** — budowa własnego agenta z trwałą pamięcią\n- **Automatyzacja przepływu pracy** — łańcuch narzędzi Synapse w własnych przepływach\n- **Potoki danych** — ekstrakcja wspomnień, transformacja, ładowanie gdzie indziej\n- **Panele monitoringu** — wyświetlanie statystyk pamięci, historii czatu, zadań\n\n## Następne kroki\n\n- [Specyfikacja MCP](https://spec.modelcontextprotocol.io)\n- [Repozytorium Synapse MCP](https://gitlab.com/schaefer-services/synapse-mcp)\n- [Przegląd API](/docs/api/overview)\n","content_html":"

Budowa niestandardowego klienta MCP

\n

Jeśli buduje się własną aplikację LLM, można połączyć się z serwerem Synapse MCP\nbezpośrednio, używając oficjalnego SDK MCP. Daje to aplikacji dostęp do wszystkich\n79 narzędzi Synapse.

\n

SDK

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
JęzykPakiet
TypeScript/JavaScript@modelcontextprotocol/sdk
Pythonmcp
\n

Przykład w TypeScript

\n

Instalacja

\n
npm install @modelcontextprotocol/sdk

Połączenie przez 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// Lista wszystkich dostępnych narzędzi\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// Wywołanie narzędzia\nconst result = await client.callTool({\n  name: "memory_recall",\n  arguments: {},\n});\nconsole.log(result.content);\n\n// Zapis wspomnienia\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();

Połączenie przez HTTP/SSE (zdalne)

\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// ... użycie jak wyżej

Przykład w Pythonie

\n

Instalacja

\n
pip install mcp

Połączenie przez 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        # Lista narzędzi\n        tools = await session.list_tools()\n        print(f"Available tools: {len(tools.tools)}")\n\n        # Wywołanie narzędzia\n        result = await session.call_tool("memory_recall", {})\n        print(result.content)\n\n        # Zapis wspomnienia\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        })

Profile narzędzi

\n

Podczas łączenia można zażądać konkretnego profilu narzędzi przez nagłówek\nMcp-Tool-Profile (HTTP/SSE) lub zmienną środowiskową MCP_PROFILE (stdio):

\n
// stdio: ustawienie zmiennej środowiskowej\nenv: {\n  SYNAPSE_MIND_KEY: "mk_...",\n  MCP_PROFILE: "minimal",  // 8 narzędzi zamiast 119\n}\n\n// HTTP/SSE: ustawienie nagłówka\nrequestInit: {\n  headers: {\n    Authorization: "Bearer mk_...",\n    "Mcp-Tool-Profile": "minimal",\n  },\n}

Obsługa błędów

\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}

Przypadki użycia

\n\n

Następne kroki

\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"]}