Open Collective MCP

开放式集体MCP服务器


让你的AI助手管理你的 开放集体 页面——通过自然语言更新配置文件、发布帖子、创建项目、配置层和跟踪财务。

建造于 公民基础设施建设者俱乐部.

示例

连接后，您可以向您的AI助手询问以下问题：

“让我看看我们集体的平衡”

助理打来电话 oc-get-balance 并返回：

{
  "balance": { "value": 1250.00, "currency": "USD" },
  "totalAmountReceived": { "value": 8400.00, "currency": "USD" },
  "totalAmountSpent": { "value": 7150.00, "currency": "USD" }
}

“在我们的集体下创建一个名为‘社区花园’的项目”

助理打来电话 oc-create-project 使用名称和描述，项目将显示在您的Open Collective页面上。

工具（19）

快速开始

1.获得开放式集体个人代币

转到您的Open Collective帐户 设置→ 对于开发者→ 个人代币当创建令牌时， 启用所有可用作用域 --至少 account 写操作（创建项目、编辑配置文件、发布更新）需要范围。没有它，突变将失败，并“不允许在范围帐户中进行操作”

速率限制：使用个人令牌每分钟100个请求。

2.部署自己的实例

每个用户都使用自己的Open Collective令牌部署自己的实例——服务器代表配置令牌的人进行操作。您可以在任何运行Node.js的平台（Railway、Fly.io、Render、VPS等）上托管它，也可以在本地运行它。

选项A：铁路（远程HTTP）


设置这些环境变量：

选项B：本地运行（stdio）

git clone https://github.com/Citizen-Infra/open-collective-mcp.git
cd open-collective-mcp
npm install && npm run build
OPEN_COLLECTIVE_TOKEN= node dist/index.js

为了开发，使用 npm run dev 跳过构建步骤（使用tsx运行）。

3.连接您的MCP客户端

克劳德代码

远程HTTP（铁路）：

claude mcp add --transport http \
  --header "Authorization: Bearer " \
  -s user open-collective \
  https:///mcp

本地标准：

claude mcp add -e OPEN_COLLECTIVE_TOKEN= \
  -s user open-collective -- node /path/to/open-collective-mcp/dist/index.js

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "open-collective": {
      "command": "node",
      "args": ["/path/to/open-collective-mcp/dist/index.js"],
      "env": {
        "OPEN_COLLECTIVE_TOKEN": ""
      }
    }
  }
}

Cursor/Windsurf/其他MCP客户端

使用上面的stdio配置——命令是 node /path/to/open-collective-mcp/dist/index.js 随着 OPEN_COLLECTIVE_TOKEN 作为环境变量。有关确切的配置格式，请参阅客户的MCP文档。

发展

npm install
npm run dev              # stdio mode (local)
PORT=3000 npm run dev    # HTTP mode (local)
npm run build            # compile TypeScript

建筑

• 运行时间： Node.js+TypeScript @modelcontextprotocol/sdk
• 运输： 双模--stdio供本地使用（否 PORT)，用于托管部署的流式HTTP(PORT 设置）
• GraphQL： 轻量级 fetch 包装物 https://api.opencollective.com/graphql/v2
• 认证： 两层-- Personal-Token OC API的标题；持有者代币(API_KEY)用于HTTP模式下的MCP客户端身份验证
• 结构： 两层分离-- tools/ 定义MCP模式和处理程序， queries/ 保存原始GraphQL字符串

路线图

• \[\]发布到npm npx -y open-collective-mcp 安装
• \[\]通过以下方式安装一个命令 npx add-mcp
• \[\]费用提交和审批工具
• \[\]事件管理工具
• \[\]Webhook支持实时通知

贡献

欢迎投稿！此项目使用启用严格模式的TypeScript。

git clone https://github.com/Citizen-Infra/open-collective-mcp.git
cd open-collective-mcp
npm install
npm run dev    # runs with tsx, no build step needed

在提交PR之前，请确保 npm run build 无差错通过。

请参阅 API文件 对于Open Collective GraphQL模式。

许可证

麻省理工学院