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