MCP 服务器

一个以 @capydb/mcp 发布的 Model Context Protocol 服务器。它可以在本地通过 stdio 运行，也可以远程通过 Streamable HTTP 在 https://mcp.capydb.dev/mcp 运行，并调用与控制台和 CLI 相同的控制平面 API——组织范围相同、权限相同、审计记录相同。

它自带手写客户端，运行时不依赖 SDK，因此安装体积小、启动即刻完成。

网页版、桌面版和移动版的 Claude，以及任何支持远程 MCP 服务器的客户端，都连接到 https://mcp.capydb.dev/mcp。无需安装，也无需粘贴密钥：某个工具第一次需要你的账户时，客户端会在浏览器里带你完成 CapyDB 登录，你在那里选择它可以使用的工作区。一次性的临时数据库在登录前就能用。

这个连接是一个智能体 API 密钥，列在 设置 → API 密钥 中，随时可以吊销。它 90 天后过期，届时客户端会请你重新连接。在 Claude Code 中，用下面的命令添加同一个 URL。

claude mcp add --transport http capydb https://mcp.capydb.dev/mcp

把它加进任意 MCP 客户端的服务器配置。认证由服务器自己处理：首次在没有密钥的情况下使用时，它会返回一个设备登录 URL，供你在浏览器里批准。

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

• -通过远程服务器使用的网页版、桌面版和移动版 Claude；远程或本地的 Claude Code
• -Cursor、Windsurf 以及其他支持 MCP 的编辑器
• -任何以 stdio 或 Streamable HTTP 实现 Model Context Protocol 的客户端——服务器同时提供当前与旧版协议修订
• -你自己的智能体，通过任意 MCP SDK

• -项目：列出、创建、查看；可认领也可销毁的临时数据库
• -连接：获取直连与池化连接字符串，以及 K/V 存储的凭据
• -SQL：只读查询，以及作为单独工具、会修改数据的语句，结果以结构化 JSON 返回
• -schema：查看表、列、索引与扩展
• -预览：创建、列出、重置和删除预览数据库
• -备份：创建与列出备份、导出转储、创建恢复点、恢复到预览库
• -导入：从其他服务商发起并跟踪导入
• -运维：用量、日志、可观测性、告警、任务与索引建议

只读工具自我声明为只读，破坏性工具自我声明为破坏性，客户端因此可以加以约束。没有 WHERE 的 UPDATE 或 DELETE，以及 TRUNCATE，会被控制平面在执行前拒绝，拒绝信息会告诉智能体怎么修正调用；MCP 服务器从不绕过这项检查。更危险的操作，工具说明会要求智能体先创建恢复点。

覆盖生产数据库的恢复被刻意排除在工具之外。智能体可以恢复到预览里，再由你自己决定是否提升；它无法自作主张覆盖你的生产数据。

服务器关于自身的所有输出都走标准错误，因为标准输出是协议通道。如果客户端显示工具列表为空，答案几乎总在客户端的 MCP 日志里，而不在服务器。