FogBugz MCP 服务器

一个用于通过语言学习模型 (LLM)，例如 Claude，与 FogBugz 交互的模型上下文协议 (MCP) 服务器。

概述

此服务器允许 LLM 对 FogBugz 执行各种操作，包括：

• 创建带有可选附件的新问题/案例
• 更新现有案例（更改项目、区域、里程碑、优先级）
• 将案例分配给特定用户
• 列出用户的未结案例
• 获取指向特定案例的直接链接
• 通过各种条件搜索案例

该服务器实现了 模型上下文协议 (MCP) 规范，允许任何 MCP 兼容的 LLM 客户端使用它。

项目背景

该项目是在 OpenAI 的 o3-mini-high 模型 的帮助下启动的，该模型生成了一个全面的开发计划（请参阅存储库中的 DEVELOPMENT-PLAN.md）。该计划概述了使用 TypeScript 构建 FogBugz MCP 服务器的架构、工具和实现细节。

详细的规范作为开发团队的蓝图，展示了 AI 如何有效地协助项目设计和规划的早期阶段。该项目既是 AI 辅助开发的示例，也是通过 MCP 协议增强 AI 功能的工具。

安装

# 从 npm 安装
npm install -g fogbugz-mcp

# 或者直接使用 npx
npx fogbugz-mcp <fogbugz-url> <api-key>

用法

基本用法

# 使用命令行参数运行
fogbugz-mcp https://yourcompany.fogbugz.com your-api-key

# 或者使用环境变量
export FOGBUGZ_URL=https://yourcompany.fogbugz.com
export TEST_FOGBUGZ_API_KEY=your-api-key
fogbugz-mcp

开发

# 克隆存储库
git clone https://github.com/yourusername/fogbugz-mcp.git
cd fogbugz-mcp

# 安装依赖
npm install

# 创建一个包含 FogBugz 凭据的 .env 文件
echo "FOGBUGZ_URL=https://yourcompany.fogbugz.com" > .env
echo "TEST_FOGBUGZ_API_KEY=your-api-key" >> .env

# 运行 API 浏览器以测试 FogBugz API
npm run explore

# 运行服务器的开发版本
npm run dev

# 运行测试
npm test

# 构建项目
npm run build

API 浏览器

该项目包含一个 API 浏览器工具，用于直接测试 FogBugz API 端点：

# 运行所有 API 测试
npm run explore

# 运行特定测试（按索引）
npm run explore 0  # 运行第一个测试

MCP 工具

此服务器为 LLM 提供以下 MCP 工具：

• fogbugz_create_case - 创建一个新的 FogBugz 案例
• fogbugz_update_case - 更新现有案例的字段
• fogbugz_assign_case - 将案例分配给特定用户
• fogbugz_list_my_cases - 列出分配给特定用户的案例
• fogbugz_search_cases - 使用查询字符串搜索案例
• fogbugz_get_case_link - 获取指向特定案例的直接链接

许可证

ISC