butterstack-mcp

一个用于 ButterStack 的 Model Context Protocol (MCP) 服务器：让 AI 助手能够读写你的游戏开发流水线、任务、构建和资产审批。

零运行时依赖。仅使用 Node 内置模块。

安装

将此配置添加到你的 MCP 客户端配置中。无需全局安装，npx 会按需获取：

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"]
    }
  }
}

Claude Desktop

编辑 claude_desktop_config.json（设置 -> 开发者 -> 编辑配置），将上面的配置块添加到 mcpServers 下，然后重启 Claude Desktop。

Cursor

将相同的配置块添加到项目中的 .cursor/mcp.json，或添加到全局 Cursor MCP 设置中，放在 mcpServers 下。

Antigravity

将相同的配置块添加到你的 Antigravity MCP 配置中，放在 mcpServers 下。

身份验证

在客户端的 MCP 服务器环境中设置 BUTTERSTACK_API_TOKEN。这是主要且推荐的身份验证方式：它可以独立工作，无需安装其他任何东西。

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"],
      "env": {
        "BUTTERSTACK_API_TOKEN": "your-token-here"
      }
    }
  }
}

从你的 ButterStack 账户设置中生成一个令牌。

如果你另外安装了 ButterStack CLI 并且已经运行过 butter auth login，此服务器也会读取它存储在磁盘上的凭据（~/.config/butterstack/credentials.json），这样你就不必重复配置令牌。但 CLI 不是此包的依赖项，安装它也不是必需的：仅设置 BUTTERSTACK_API_TOKEN 就足够了。

主机

默认情况下，服务器连接到 https://www.butterstack.com。要将其指向自托管或本地实例，请设置 BUTTERSTACK_HOST：

{
  "env": {
    "BUTTERSTACK_API_TOKEN": "your-token-here",
    "BUTTERSTACK_HOST": "http://localhost:3000"
  }
}

服务器拒绝将存储的凭据发送到非其签发目标的主机。如果你看到 "Refusing to send the stored credential" 错误，请将 BUTTERSTACK_HOST 设置为与你的凭据签发主机一致，或者为你要指向的主机生成一个新凭据。

工具

每个工具都接受一个 project_id（projects_list 除外），可以是数字项目 ID 或项目名称。

提示词

资源

要求

Node 18 或更高版本。这是受支持版本的政策，而非硬性技术下限：服务器仅使用兼容至 Node 10.9.0 的内置模块，但 18 是此包实际测试过的最旧版本。

许可证

MIT