Seam MCP Server

什么是 Seam MCP Server？

Seam MCP Server 是 Seam 官方提供的免费文档服务器，面向 AI 编程助手：一个公开、只读的 MCP 端点，让 Claude、Cursor、VS Code 等客户端直接获取 Seam 文档、API 参考和设备目录。无需 API 密钥，也无需登录。

Seam 是一套 API，通过一次集成即可连接并控制来自众多厂商的智能门锁、温控器、门禁系统等楼宇设备。基于 Seam 开发时，开发者需要准确的细节：有哪些端点、某个提供商支持哪些门锁型号、访问码或 Connect Webviews 如何工作。Seam MCP 服务器把这些文档放进助手里，让它写出的代码基于最新文档而不是记忆。它不会控制设备，也不会访问你的 Seam 工作区。

如何使用 Seam MCP Server？

无需安装任何东西，也无需配置凭据。服务器地址：

https://mcp.seam.co/mcp

它使用 Streamable HTTP，无需身份验证。/mcp 路径是必需的。

Claude Code

Seam 文档给出的命令：

claude mcp add --transport http seam https://mcp.seam.co/mcp

Claude Desktop 和 claude.ai

打开 Settings > Connectors，点击 Add custom connector，填写名称（例如“Seam”）并输入 https://mcp.seam.co/mcp。没有登录步骤。

Cursor

Seam 的 MCP 页面提供一键“Install in Cursor”按钮，也可以在项目的 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "seam": {
      "url": "https://mcp.seam.co/mcp"
    }
  }
}

VS Code

在项目的 .vscode/mcp.json 中添加：

{
  "servers": {
    "seam": {
      "type": "http",
      "url": "https://mcp.seam.co/mcp"
    }
  }
}

其他客户端

Seam 还记录了 Windsurf（在 ~/.codeium/windsurf/mcp_config.json 中使用 serverUrl）、Codex（codex mcp add seam --url https://mcp.seam.co/mcp）以及开启 Developer Mode 的 ChatGPT Desktop 的配置方法。

Seam MCP Server 的主要功能

• 由 Seam 官方运营，免费且公开。
• 无需 API 密钥、账号或 OAuth 流程：添加 URL 即可开始提问。
• 设计上只读：不能开锁、不能创建访问码，也不能修改 Seam 工作区中的任何内容。
• 对全部 Seam 文档进行语义搜索，包括特定设备品牌的指南。
• 直接查询已记录的 Seam API，返回你所需端点的精简规范条目。
• 覆盖支持设备目录（智能门锁、温控器、门禁系统）及厂商信息。
• 内置带有辅助文件的提示词，代理可以加载并按步骤执行多步任务。

Seam MCP Server 工具

我们对线上服务器的探测返回了七个工具，分为三组：

• 文档：search_docs 对全部 Seam 文档进行语义搜索，包括支持的设备型号及其厂商。get_docs 按路径通配符获取完整页面：传入一个精确路径读取单页，或传入更宽的模式最多读取 20 页。
• API 参考：search_api 搜索已记录的 Seam API，返回带稳定 ID 的轻量条目（传入 query="*" 可列出全部条目）。get_apis 返回所选 ID 的详细规范节点。
• 提示词：search_prompts 按元数据查找提示词，get_prompt 按名称加载提示词，get_prompt_context 在代理执行之前加载该提示词的辅助文件。

Seam MCP Server 的使用场景

• 首次集成：“演示如何用 Python 通过 Seam API 开门。”
• 账号设置问题：“如何在 Seam 中创建 API 密钥？”
• 设备支持核查：“Seam 支持哪些门禁系统？”或“Seam 支持 Aqara 门锁吗？”
• 端点细节：让助手在编写调用之前，先查询某个访问码或温控器端点的参数和响应。
• 代码审查：让助手对照当前 API 规范检查已有的 Seam 集成代码。

Seam MCP Server 常见问题排查

• 工具没有显示：添加配置后重启编辑器或重新加载窗口。
• 连接错误：确认 URL 正好是 https://mcp.seam.co/mcp；/mcp 路径是必需的。
• 首次回答较慢：Seam 说明首次查询可能需要几秒钟预热，之后的查询会很快。
• 想要控制设备：该服务器只读取文档。设备操作需通过 Seam API 并使用你自己的 API 密钥。