BeanCloud Agent API

给 AI Agent 用的豆云底座

一套 Developer API Key、一份 OpenAPI、一个官方 MCP 包。把站点导航、自研工具与查询能力接进你的 Agent 工作流。

官方 MCP Server

@beancloud/mcp-server 通过 stdio 接入 Cursor 等宿主,Tools + OpenAPI Resource,对齐主流 MCP 实践。

OpenAPI 契约

机器可读的 /openapi.yaml,REST 与 MCP 共用同一套业务面,Agent 可按契约调用。

开放鉴权

bc_live_ 开发者密钥 + 可选 HMAC 写保护;与站内 JWT、内部 Bot Key 隔离。

精选 Tool 面

导航搜索、工具/游戏目录、IP/Whois lookup、收藏读写——先交付高价值只读,再扩展写能力。

在 Cursor 里接入

三步把豆云变成侧边 Agent 可用的工具。

  1. 登录豆云,在「API Keys」创建一把 bc_live_ 密钥(仅显示一次)。
  2. 把下方 JSON 写入 Cursor MCP 配置,填入你的 Key。
  3. 重启 MCP 后,即可让 Agent 调用 nav_search_sites、tools_list_items 等工具。
{
  "mcpServers": {
    "beancloud": {
      "command": "npx",
      "args": ["-y", "@beancloud/mcp-server"],
      "env": {
        "BEANCLOUD_API_KEY": "bc_live_YOUR_KEY",
        "BEANCLOUD_BASE_URL": "https://coffeecloud.info",
        "BEANCLOUD_LOCALE": "zh-CN"
      }
    }
  }
}

本地开发(包尚未发布到 npm)

先在 packages/mcp-server 执行 npm i && npm run build,再把下方路径换成你机器上的绝对路径。

{
  "mcpServers": {
    "beancloud": {
      "command": "node",
      "args": ["/ABS/PATH/beancloud/packages/mcp-server/dist/index.js"],
      "env": {
        "BEANCLOUD_API_KEY": "bc_live_YOUR_KEY",
        "BEANCLOUD_BASE_URL": "http://127.0.0.1:8080",
        "BEANCLOUD_LOCALE": "zh-CN"
      }
    }
  }
}
管理 API Keys