{"title":"カスタム MCP クライアントを構築","slug":"custom-client","category":"mcp","summary":"MCP SDK を使用して独自のアプリケーションから Synapse MCP サーバーに接続。","audience":["human","llm"],"tags":["mcp","custom","sdk","development"],"difficulty":"advanced","updated":"2026-06-27","word_count":94,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# カスタム MCP クライアントを構築\n\n独自の LLM アプリケーションを構築している場合、公式 MCP SDK を使用して Synapse MCP サーバーに直接接続できます。これにより、アプリは 79 個すべての Synapse ツールにアクセスできます。\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// List all available tools\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// Call a tool\nconst result = await client.callTool({\n name: \"memory_recall\",\n arguments: {},\n});\nconsole.log(result.content);\n\n// Store a memory\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// ... use as above\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 # List tools\n tools = await session.list_tools()\n print(f\"Available tools: {len(tools.tools)}\")\n\n # Call a tool\n result = await session.call_tool(\"memory_recall\", {})\n print(result.content)\n\n # Store a memory\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接続時に、`Mcp-Tool-Profile` ヘッダー（HTTP/SSE）または `MCP_PROFILE` 環境変数（stdio）で特定のツールプロファイルを要求できます：\n\n```typescript\n// stdio: set env var\nenv: {\n SYNAPSE_MIND_KEY: \"mk_...\",\n MCP_PROFILE: \"minimal\", // 8 tools instead of 119\n}\n\n// HTTP/SSE: set header\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- **カスタム AI アシスタント** — 永続的メモリを持つ独自エージェントを構築\n- **ワークフロー自動化** — カスタムワークフローで Synapse ツールをチェーン\n- **データパイプライン** — メモリを抽出、変換、他の場所にロード\n- **監視ダッシュボード** — メモリ統計、チャット履歴、タスクを表示\n\n## 次のステップ\n\n- [MCP Specification](https://spec.modelcontextprotocol.io)\n- [Synapse MCP Repo](https://gitlab.com/schaefer-services/synapse-mcp)\n- [API Overview](/docs/api/overview)\n","content_html":"

カスタム MCP クライアントを構築

\n

独自の LLM アプリケーションを構築している場合、公式 MCP SDK を使用して Synapse MCP サーバーに直接接続できます。これにより、アプリは 79 個すべての Synapse ツールにアクセスできます。

\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// List all available tools\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// Call a tool\nconst result = await client.callTool({\n  name: "memory_recall",\n  arguments: {},\n});\nconsole.log(result.content);\n\n// Store a memory\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// ... use as above

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        # List tools\n        tools = await session.list_tools()\n        print(f"Available tools: {len(tools.tools)}")\n\n        # Call a tool\n        result = await session.call_tool("memory_recall", {})\n        print(result.content)\n\n        # Store a memory\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

接続時に、Mcp-Tool-Profile ヘッダー（HTTP/SSE）または MCP_PROFILE 環境変数（stdio）で特定のツールプロファイルを要求できます：

\n
// stdio: set env var\nenv: {\n  SYNAPSE_MIND_KEY: "mk_...",\n  MCP_PROFILE: "minimal",  // 8 tools instead of 119\n}\n\n// HTTP/SSE: set header\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"]}