MCP 服务器

一个以 @capydb/mcp 发布的 Model Context Protocol 服务器。它说 stdio、在本地运行，并调用与控制台和 CLI 相同的控制平面 API——组织范围相同、权限相同、审计记录相同。

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

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

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

• -Claude Code 与 Claude 桌面应用
• -Cursor、Windsurf 以及其他支持 MCP 的编辑器
• -任何以 stdio 实现 Model Context Protocol 的客户端——服务器同时提供当前与旧版协议修订
• -你自己的智能体，通过任意 MCP SDK

• -项目：列出、创建、查看、重命名、暂停、恢复、删除
• -连接：获取直连与池化连接字符串、轮换凭据
• -SQL：对项目执行查询与语句，结果以结构化 JSON 返回
• -schema：查看表、列、索引与扩展
• -预览：创建、列出、重置和删除预览数据库
• -备份：列出备份、创建恢复点、把预览恢复到某个时间点
• -导入：从其他服务商发起并跟踪导入
• -工作区：组织、成员、API 密钥、用量与审计记录

只读工具自我声明为只读，破坏性工具自我声明为破坏性，客户端因此可以加以约束。破坏性 SQL 必须先有恢复点——服务器会提示智能体去创建，而不是直接执行语句。

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

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