Kaiva Bridge

Kaiva Bridge

Kaiva Bridge 可将 API、数据库或文档转换为托管的 MCP 服务，供 Claude、ChatGPT、Cursor、VS Code 和其他 AI 客户端使用。本页首先介绍 Kaiva Bridge 连接器 ai.kaiv/bridge，随后介绍命令行工具。

将 Kaiva Bridge 用作 MCP 连接器（ai.kaiv/bridge）

Kaiva Bridge 本身也是一个 MCP 服务，因此你的 AI 客户端可以在聊天中创建和管理 MCP 服务。它已在官方 MCP Registry 中列出，名称为 ai.kaiv/bridge，也列在 Claude 的连接器目录中。

• 地址：https://api.kaiv.ai/api/bridge/manage/mcp（Streamable HTTP）
• 登录：使用你的 Kaiva Bridge 账户通过 OAuth 2.1 登录（免费，无需信用卡）。无需复制密钥。
• 工具：list_my_servers、get_server、create_server（根据 OpenAPI 规范 URL 起草服务）和 reintrospect_server（API 发生变化时刷新服务的工具）。

连接器负责起草和列出服务。发布服务和启用其工具需由你在控制台中完成。

**VS Code 和 GitHub Copilot：**点击 kaiv.ai/bridge 上的 Add to VS Code，或在 VS Code 中运行 MCP: Add Server 并输入上述地址，然后按提示登录。 Claude：claude.ai/directory/kaiva-bridge。 Claude Code：claude mcp add --transport http --scope user kaiva-bridge https://api.kaiv.ai/api/bridge/manage/mcp。 **Cursor 和 ChatGPT：**使用 kaiv.ai/bridge 上的 Add 菜单。

然后询问：“列出我的 Kaiva Bridge 服务”或“根据 https://petstore3.swagger.io/api/v3/openapi.json 创建一个 Kaiva Bridge 服务”。

命令行工具

从终端将任意 API 或数据库发布为可用的 MCP 服务。

Kaiva Bridge 可将 OpenAPI 规范、数据库（PostgreSQL、MySQL、MariaDB 或 SQL Server）或远程 MCP 服务转换为托管的 MCP 服务，供你的 Agent 调用。此 CLI 通过 Management API 驱动服务。每条设置命令都可以安全地重复运行。

供编码 Agent 使用

通过 Kaiva Bridge 将 AI Agent 连接到 API、数据库和文档。安装此 skill，让编码 Agent 为你设置托管的 MCP 连接。无需账户即可试用公共 API。

适用于 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 和其他兼容的编码 Agent。

npx skills add ai-kaiva/bridge

安装

无需安装。Node 18+ 已包含所需的一切：

npx @kaiva/bridge help

无需账户即可试用

对于公共 API 规范，只需运行一条命令即可获得可用的 MCP 服务。无需账户，也无需登录：

npx @kaiva/bridge try --openapi https://petstore3.swagger.io/api/v3/openapi.json

你将获得服务地址、该服务专用的密钥以及认领链接。服务仅提供规范中的 GET 操作，有效期为 72 小时或 500 次调用。打开认领链接即可将其保留在你的工作区中：服务地址保持不变，并适用你套餐的限制。认领后密钥将失效，因此请从控制台重新连接 AI 客户端。之后，你可以添加 API 密钥并启用其他操作。编码 Agent 可以自行完成这些操作（--json 会输出一个 JSON 对象）。

在云端 Agent 沙盒（Codex cloud、Claude Code on the web）中，请先允许访问域名 api.kaiv.ai 和 registry.npmjs.org：这些域名的网络访问默认关闭或受限。

Claude Code 插件

claude plugin marketplace add ai-kaiva/bridge
claude plugin install kaiva-bridge@kaiva

或者仅复制 skill：npx @kaiva/bridge skill install。

在本机使用 Postgres，无需账户

如果 Postgres 数据库只供本机上的 AI 客户端使用，Kaiva Postgres MCP 是一个免费、开源的 MCP 服务，可在本地运行且仅提供读取功能。它取代了已归档的 @modelcontextprotocol/server-postgres：只需更改包名，其他内容无需改动。

claude mcp add postgres -- npx -y @kaiva/postgres-mcp postgresql://localhost/mydb
# or, from the same plugin marketplace as above (reads DATABASE_URL from your environment)
claude plugin install postgres-mcp@kaiva

如果你需要在 Claude.ai 或 ChatGPT 中使用同一个数据库，或供团队使用，可通过下文的 push --db 将其托管在 Bridge 上。

身份验证

npx @kaiva/bridge login

终端会显示一个代码并打开控制台。在控制台中输入该代码并批准（需要是工作区所有者或管理员）。密钥会保存在本机的 ~/.config/kaiva-bridge/credentials.json 中，且只有你能读取。whoami 会显示正在使用的工作区和密钥；logout 会撤销密钥并将其删除。

对于 CI 和脚本，请改用控制台中的 Management 密钥（Keys & access，密钥类型为 Management）。设置后，它会替代已保存的登录信息：

export KAIVA_BRIDGE_TOKEN=kv_mgmt_...

logout 只会撤销已保存的登录信息。你在 KAIVA_BRIDGE_TOKEN 中提供的密钥由你自行管理：取消设置该变量，并在不再需要密钥时于控制台中撤销。重新登录会撤销被替换的登录信息。

MCP 网关不接受 Management 密钥，Management API 也不接受网关密钥：这两种凭证不能互换。

快速入门：从数据源到运行中的服务

# An API spec (only operations that read are exposed with --read-only)
npx @kaiva/bridge push my-api --openapi https://api.example.com/openapi.json --read-only

# A database: DATABASE_URL from the environment or .env; Postgres, MySQL, MariaDB or SQL Server
npx @kaiva/bridge push shop-db --db --read-only
# → LIVE  https://api.kaiv.ai/api/bridge/mcp/shop-db-a1b2c3d4
# → check  first call: get_orders answered in 84ms (and what the AI is given)

# Documents: PDF, Word, PNG, JPEG, text or Markdown files, or a folder of them
npx @kaiva/bridge push handbook --docs ./policies
# waits until each file is read, then → LIVE  https://api.kaiv.ai/api/bridge/mcp/handbook-a1b2c3d4

npx @kaiva/bridge install my-api --client claude-code   # or --client cursor

install 会将服务添加到 Claude Code（此文件夹的 .mcp.json，或使用 --global）或 Cursor（~/.cursor/mcp.json，或使用 --project），并保留其他所有条目。客户端首次使用时会通过你的 Kaiva 账号登录；--key 则会为此服务写入一个密钥。--dry-run 会显示变更；uninstall 会移除该服务。对于其他 MCP 客户端，使用 key <server-id> --label <client> --replace 生成网关密钥，以便复制并与端点一同粘贴。再次运行相同命令不会产生重复内容：push 会重复使用同名服务，install 会保留现有条目不变，而 key --replace 会替换带有该标签的密钥。

让你的编码 Agent 来完成

npx @kaiva/bridge skill install        # adds the setup skill to Claude Code (~/.claude/skills)

然后提出请求：“通过 Kaiva Bridge 将我的数据库连接到 Claude Code”。该技能会运行下方的命令，在不检查证书或公开具有写入功能的操作前征求你的同意，并通过首次工具调用进行确认。

示例

examples/ 中可运行的脚本：

• database-to-claude-code.sh：将 Postgres、MySQL 或 MariaDB 数据库连接到 Claude Code
• openapi-to-cursor.sh：将 OpenAPI 规范连接到此项目的 Cursor
• call-from-your-app.mjs：从你自己的 Node 应用调用 MCP 服务，无需依赖

命令

命令	作用
push <name> --openapi <url>	根据 OpenAPI 规范创建、检视、公开并发布
push <name> --mcp <url>	包装现有的远程 MCP 服务，并选择要提供的工具
push <name> --postgres <conn>	从 Postgres 数据库提供只读工具
push <name> --mysql <conn>	从 MySQL 或 MariaDB 数据库提供只读工具
push <name> --graphql <endpoint>	从 GraphQL API 的查询中读取工具（不提供变更操作）
push <name> --sqlserver <conn>	从 SQL Server 或 Azure SQL 数据库提供只读工具（sqlserver://… 或 Server=…;Database=…;User ID=…;Password=…）
push <name> --docs <files or folders>	提供 AI 可搜索和逐页阅读的文档；再次指定同名文件会替换该文档。--no-wait 会在文件发送完成后立即返回
push <name> --db [--db-env NAME]	使用环境变量或 .env.local/.env 中的 DATABASE_URL（或 NAME）连接数据库；根据地址识别数据库引擎，地址不会出现在命令行中
push … --read-only	仅公开读取操作；写入操作默认关闭，直到你选择启用
push … --no-check	跳过每次 push 和 try 结束时执行的设置检查：进行一次实际调用、启用写入、检查工具列表大小和疑似私有的表
push … --ca-file <pem> / --no-verify-tls	对于使用自签名证书的数据库：通过服务提供商的 CA 进行验证，或在不验证的情况下连接
login [--no-browser]	在控制台批准此设备，并为其保存密钥
whoami	查看正在使用的工作区、账户和密钥
logout	撤销此设备的密钥并将其移除
skill install [--project]	为编码 Agent 添加设置技能
install <server> --client claude-code|cursor	将实时服务添加到客户端配置中；可使用 --key、--dry-run、--global（Claude Code）、--project（Cursor）
uninstall <server> --client claude-code|cursor	移除服务，并撤销 install 添加的密钥
doctor <server> [--call <tool>]	检查可访问性、登录状态、发布状态、MCP 握手和工具列表；每一步都会通过、返回带有代码和修复方法的失败信息，或说明未运行。--call 会使用一个读取工具进行一次调用。最后会生成供支持人员使用的回执（不含机密信息）
servers	列出服务及其状态和来源
publish <server-id>	发布草稿服务
key <server-id> [--label L] [--replace]	创建作用域限定于服务的网关密钥（仅显示一次）；--replace 会撤销之前具有该标签的密钥
introspect <server-id>	重新读取来源。若合约变更被暂存，则退出码为 3
revisions <server-id>	查看合约历史：变更时间和涉及的工具
promote <server-id>	发布已暂存的变更
reject <server-id>	丢弃变更并恢复当前提供的版本
auto-publish <server-id> [--off]	自动发布合约变更，无需审核
invoke <server-id> <tool-id> [--args '{"k":"v"}']	通过实际的受管控路径测试调用工具（会记录审计日志）
logs [--limit 50]	实时查看审计日志
metrics [--range 24h]	查看工作区关键指标（1h · 24h · 7d · 30d）

在 push、key、install、whoami 和 doctor 命令中使用 --json，会在标准输出中打印一条 JSON 结果（进度信息写入标准错误），供脚本和 Agent 使用。KAIVA_BRIDGE_URL 可覆盖 API 基础地址 （默认为 https://api.kaiv.ai/api/bridge/v1）。

注册前先试用

无需账户，即可在浏览器中调用实时示例服务： https://app.kaiv.ai/try

---

MIT © SLATEAI LIMITED · kaiv.ai/bridge