MCP 接入指南

将具身空间知识库接入 Claude Desktop 或 Cowork，直接在对话中调用知识库工具。

MCP Server 已上线

消息端点（推荐）	https://embodied-space.web.app/mcp/messages
Cloud Functions	https://us-central1-embodied-space.cloudfunctions.net/mcpServer

推荐使用 Firebase Hosting 代理地址，网络兼容性更好；Cloud Functions 直连在部分网络环境下可能超时。

🖥 方式一：Claude Desktop

需要 Node.js 环境（用于运行 mcp-remote 桥接包）

1 打开 Claude Desktop 配置文件：
%APPDATA%\Claude\claude_desktop_config.json
2 将以下内容合并到 mcpServers 字段：

"embodied-space-kb": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://us-central1-embodied-space.cloudfunctions.net/mcpServer"
  ]
}

⚠️ 使用 Clash / VPN 的用户（Tun 模式）

mcp-remote 子进程不会自动继承系统代理，直连 Google 服务会超时。需在配置中显式传入代理地址（将端口替换为你的实际代理端口，Clash 默认 7890）：

"embodied-space-kb": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://us-central1-embodied-space.cloudfunctions.net/mcpServer"
  ],
  "env": {
    "HTTP_PROXY": "http://127.0.0.1:7890",
    "HTTPS_PROXY": "http://127.0.0.1:7890"
  }
}

保存后完全退出 Claude Desktop（任务栏托盘右键 Quit）再重新打开即生效。

⚡ 方式二：Cowork（HTTP 直连）

在工作目录的 .claude/settings.json 中添加：

{
  "mcpServers": {
    "embodied-space-kb": {
      "type": "http",
      "url": "https://us-central1-embodied-space.cloudfunctions.net/mcpServer"
    }
  }
}

🔌 方式三：第三方 AI 工具

支持 HTTP MCP 直连的客户端（Codex、Qoderwork 等）可直接配置端点，无需本地桥接进程。

HTTP 直连配置（通用）

{
  "mcpServers": {
    "embodied-space-kb": {
      "type": "http",
      "url": "https://embodied-space.web.app/mcp"
    }
  }
}

手动验证（JSON-RPC over HTTP）

消息入口：https://embodied-space.web.app/mcp/messages

① 握手（Initialize）

curl -X POST https://embodied-space.web.app/mcp/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
    "protocolVersion":"2024-11-05","capabilities":{},
    "clientInfo":{"name":"client","version":"1.0"}}}'

② 列出工具（tools/list）

curl -X POST https://embodied-space.web.app/mcp/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

③ 调用工具（tools/call）

curl -X POST https://embodied-space.web.app/mcp/messages \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{"name":"list_symbols","arguments":{}}}'

🔧 可用工具（6 个）

search_theory

在 EST / ESP / EICPS 理论全文中语义搜索（覆盖 20 章知识索引）

输入：{ query: string }

get_concept

获取概念精确数学定义与参考链接

输入：{ concept: string }

get_chapter

获取某章节完整正文（按标题、slug 或 id 检索）

输入：{ chapter: string }

list_symbols

返回完整符号表（14 个核心符号）

输入：{}

compare_frameworks

对比 EICPS 与主流 VLA / 扩散框架的核心差异

输入：{}

get_literature

按领域获取参考文献

输入：{ domain: "vla"|"pinn"|"hybrid"|"geometry"|"safety"|"all" }

✅ 验证接入是否成功

在 Claude 对话框中输入：

"使用 embodied-space-kb 的 list_symbols 工具，列出 EICPS 核心符号表"

如果返回符号表，说明 MCP Server 接入成功。也可直接访问端点 GET 请求验证服务状态：打开端点 →