{"title":"MCP 是什么？","slug":"what-is-mcp","category":"mcp","summary":"Model Context Protocol 让 LLM 调用外部工具。Synapse 通过官方 MCP Server 暴露 79 个工具。","audience":["human","llm"],"tags":["mcp","intro","overview"],"difficulty":"beginner","updated":"2026-06-27","word_count":426,"read_minutes":2,"llm_context":"MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.\nSynapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)\n79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility\n3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)\nSupported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client\nTool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header\n","lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# MCP 是什么？\n\n**Model Context Protocol (MCP)** 是 Anthropic 于 2024 年推出的开放标准，让 LLM 以结构化方式调用外部工具。你不需要把 API 文档粘到 prompt 里，而是把工具注册到 MCP Server，LLM 按需调用 — 类似 function calling，但标准化且与客户端无关。\n\n## Synapse MCP Server\n\nSynapse 提供官方 MCP Server（npm 上的 `synapse-mcp-api`），暴露覆盖所有 Synapse 功能的 **79 个工具**：\n\n| 分类 | 工具 | 数量 |\n|----------|-------|-------|\n| Memory | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |\n| Chat | poll, reply, status, history, unread, send, upload | 7 |\n| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |\n| Tasks | task_list, task_get, task_create, task_update | 4 |\n| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |\n| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |\n| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |\n| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |\n| Utility | time, calc, random | 3 |\n| Visualization | graph, tags, compact | 3 |\n| Sharing | share, list, revoke | 3 |\n| Webhooks | register, list, get, update, delete | 5 |\n| Browser | new, navigate, click, type, screenshot, close | 6 |\n| **合计** | | **79+** |\n\n## 工作原理\n\n```\n┌──────────────────┐ MCP 协议 ┌──────────────────┐ HTTP ┌──────────┐\n│ LLM 客户端 │ ◀─────────────────▶│ Synapse MCP │ ─────────▶ │ Synapse │\n│ (Claude/Cursor) │ (stdio/SSE/WS) │ Server │ │ API │\n└──────────────────┘ └──────────────────┘ └──────────┘\n```\n\n1. 你把 LLM 客户端（Claude Desktop、Cursor 等）配置为使用 Synapse MCP Server\n2. 客户端启动 MCP Server（通过 `npx -y synapse-mcp-api@latest`）\n3. MCP Server 用你的 Mind Key 连接到 Synapse API\n4. LLM 看到全部 79 个工具，作为可调用的原生函数\n5. 当 LLM 需要记住某事时，它调用 `memory_store` — MCP Server 把它翻译为 Synapse 上的 `POST /memory`\n\n## 传输方式\n\nSynapse MCP Server 支持三种传输方式：\n\n### stdio（本地，桌面端推荐）\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_...\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n### HTTP/SSE（远程，多租户）\n\n把你的 MCP 客户端连接到：\n\n```\nURL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY\n```\n\n### WebSocket（移动端，高吞吐）\n\n```\nURL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY\n```\n\n## 工具配置文件（v1.4.0）\n\n为减小较小 LLM 的 token 开销，MCP Server 支持三种工具配置文件：\n\n| 配置文件 | 工具 | Tokens | 适合 |\n|---------|-------|--------|----------|\n| `minimal` | 8（组合分发） | ~500 | 上下文 ≤8k 的自托管 LLM |\n| `standard` | 25（命名） | ~2,500 | 中等大小 LLM（Claude Haiku、GPT-3.5） |\n| `full` | 119（全部） | ~8,250 | 大型 LLM（Claude Sonnet/Opus、GPT-4） — 默认 |\n\n控制方式：\n\n- 环境变量：`MCP_PROFILE=minimal|standard|full`\n- 头：`Mcp-Tool-Profile: minimal|standard|full`\n\n## 支持的客户端\n\n- [Claude Desktop](/docs/mcp/claude-desktop) — Anthropic 的桌面应用\n- [Claude Code](/docs/mcp/claude-code) — 终端编码 Agent\n- [Cursor](/docs/mcp/cursor) — AI 驱动的 IDE\n- [Continue.dev](/docs/mcp/continue) — 开源 AI 编码助手\n- [Cline](/docs/mcp/claude-code) — VS Code 扩展\n- 任何兼容 MCP 的客户端\n\n## 为什么用 MCP 而非直接 API？\n\n| 方式 | 优点 | 缺点 |\n|----------|------|------|\n| 直接 API | 简单，无额外层 | LLM 需要知道 URL、请求头、认证 |\n| MCP | LLM 看到原生工具，无需记 URL | 多一个 MCP Server 进程 |\n\n对于大多数 LLM Agent 用例，MCP 是更好的选择 — LLM 不需要记 API 路径或认证模式。\n\n## 下一步\n\n- [Claude Desktop 配置](/docs/mcp/claude-desktop) — 2 分钟配置\n- [Claude Code 配置](/docs/mcp/claude-code) — 终端集成\n- [自定义 MCP 客户端](/docs/mcp/custom-client) — 自建客户端\n","content_html":"

MCP 是什么？

\n

Model Context Protocol (MCP) 是 Anthropic 于 2024 年推出的开放标准，让 LLM 以结构化方式调用外部工具。你不需要把 API 文档粘到 prompt 里，而是把工具注册到 MCP Server，LLM 按需调用 — 类似 function calling，但标准化且与客户端无关。

\n

Synapse MCP Server

\n

Synapse 提供官方 MCP Server（npm 上的 synapse-mcp-api），暴露覆盖所有 Synapse 功能的 79 个工具：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
分类工具数量
Memoryrecall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export22
Chatpoll, reply, status, history, unread, send, upload7
Schedulercron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete8
Taskstask_list, task_get, task_create, task_update4
Scriptsscript_list, script_get, script_info, script_store, script_delete5
Computerscomputer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete9
Pushvapid_public_key, subscribe, unsubscribe, test4
User/Mindregister, login, minds_list, mind_create, mind_delete5
Utilitytime, calc, random3
Visualizationgraph, tags, compact3
Sharingshare, list, revoke3
Webhooksregister, list, get, update, delete5
Browsernew, navigate, click, type, screenshot, close6
合计79+
\n

工作原理

\n
┌──────────────────┐    MCP 协议     ┌──────────────────┐    HTTP    ┌──────────┐\n│  LLM 客户端      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │\n│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │\n└──────────────────┘                    └──────────────────┘            └──────────┘
    \n
  1. 你把 LLM 客户端（Claude Desktop、Cursor 等）配置为使用 Synapse MCP Server
    2. \n
  2. 客户端启动 MCP Server（通过 npx -y synapse-mcp-api@latest）
    3. \n
  3. MCP Server 用你的 Mind Key 连接到 Synapse API
    4. \n
  4. LLM 看到全部 79 个工具，作为可调用的原生函数
    5. \n
  5. 当 LLM 需要记住某事时，它调用 memory_store — MCP Server 把它翻译为 Synapse 上的 POST /memory
    6. \n
\n

传输方式

\n

Synapse MCP Server 支持三种传输方式：

\n

stdio（本地，桌面端推荐）

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_...",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

HTTP/SSE（远程，多租户）

\n

把你的 MCP 客户端连接到：

\n
URL: https://synapse-mcp.schaefer.zone/sse\nHeaders: Authorization: Bearer YOUR_MIND_KEY

WebSocket（移动端，高吞吐）

\n
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY

工具配置文件（v1.4.0）

\n

为减小较小 LLM 的 token 开销，MCP Server 支持三种工具配置文件：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
配置文件工具Tokens适合
minimal8（组合分发）~500上下文 ≤8k 的自托管 LLM
standard25（命名）~2,500中等大小 LLM（Claude Haiku、GPT-3.5）
full119（全部）~8,250大型 LLM（Claude Sonnet/Opus、GPT-4） — 默认
\n

控制方式：

\n\n

支持的客户端

\n\n

为什么用 MCP 而非直接 API？

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
方式优点缺点
直接 API简单，无额外层LLM 需要知道 URL、请求头、认证
MCPLLM 看到原生工具，无需记 URL多一个 MCP Server 进程
\n

对于大多数 LLM Agent 用例，MCP 是更好的选择 — LLM 不需要记 API 路径或认证模式。

\n

下一步

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