FogBugz MCP 服务器

一个用于通过 Claude 等 LLM 与 FogBugz 交互的 模型上下文协议 (MCP) 服务器。支持 XML API (/api.asp) 和 JSON API (/f/api/0/jsonapi)，并在启动时自动检测版本。适用于本地部署和按需部署的 FogBugz 安装。

概述

允许 LLM 执行 FogBugz 操作：

• 创建、更新、解决、重新打开和关闭案例

• 将案例分配给特定用户

• 搜索和列出带有完整事件/评论历史记录的案例

• 列出用户、类别、项目和区域

• 创建新项目

• 针对高级用例的通用 API 请求

API 自动检测

在启动时，服务器会自动为您的 FogBugz 实例选择正确的 API 客户端：

1. 探测 /api.xml 以读取 FogBugz 版本号。

2. 如果版本 ≥ 9，尝试连接 JSON API (/f/api/0/jsonapi) — 成功时使用 FogBugzJsonClient。

3. 如果版本 < 9 或 JSON 端点不可达，则回退到 FogBugzXmlClient (通过 /api.asp 的 XML API)。

无需配置 — 系统会自动选择正确的客户端。

关于文本格式的说明： 当通过 XML API 连接到 FogBugz 8.x 时，描述和评论中仅支持纯文本。HTML 和 Markdown 将按原样存储和显示。

获取 FogBugz API 令牌

您需要一个 API 令牌来验证 MCP 服务器与 FogBugz 的连接。有两种获取方式：

1. 通过 Web UI

转到 Account & Settings → User Options 并点击 Create API Token 链接。

请参阅官方指南：使用 FogBugz UI 创建 API 令牌

2. 通过 API 请求

发送以下请求（将占位符替换为您的值）：

https://[your-fogbugz-server]/api.asp?cmd=logon&email=[your-email]&password=[your-password]

响应将包含您的 API 令牌。

请参阅官方指南：使用 FogBugz API 命令获取 API 令牌

安装

一键安装 (Claude Desktop)

从 Releases 页面下载最新的 .mcpb 包并打开它 — Claude Desktop 将自动安装并配置服务器，并提示您输入 FogBugz URL 和 API 密钥。

手动安装

git clone https://github.com/todevelopers/fogbugz-mcp.git
cd fogbugz-mcp
npm install
npm run build

MCP 客户端配置

添加到您的 MCP 客户端配置中（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": ["/absolute/path/to/fogbugz-mcp/dist/index.js"],
      "env": {
        "FOGBUGZ_URL": "https://your-fogbugz-server.com",
        "FOGBUGZ_API_KEY": "your-api-token"
      }
    }
  }
}

或者，将凭据作为命令行参数传递：

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": [
        "/absolute/path/to/fogbugz-mcp/dist/index.js",
        "https://your-fogbugz-server.com",
        "your-api-token"
      ]
    }
  }
}

手动运行

# With command-line arguments
node dist/index.js https://your-fogbugz-server.com your-api-token

# With environment variables
FOGBUGZ_URL=https://your-fogbugz-server.com FOGBUGZ_API_KEY=your-api-token npm start

# With a .env file
cp .env.example .env   # fill in FOGBUGZ_URL and FOGBUGZ_API_KEY
npm start

开发

npm run dev    # run via ts-node (no build needed)
npm run build  # compile TypeScript to dist/
npm test       # run all Jest tests

MCP 工具

案例管理

搜索与查看

参考数据

高级

环境变量

兼容性

已在 FogBugz 8.8.53 (XML API) 上测试。JSON API 支持按规范实现。服务器在启动时会自动检测使用哪个 API。

致谢

本项目基于 Sarasvati Akari Lara-Almeida 的原始工作 — 感谢您提供的基础。

许可证

MIT © Tomáš Gažovič, ToDevelopers s.r.o.