FogBugz MCP 服务器
模型上下文协议 (MCP) 服务器,用于通过语言学习模型 (LLM)(例如 Claude)与 FogBugz 进行交互。
概述
该服务器允许 LLM 对 FogBugz 执行各种操作,包括:
- 创建带有可选附件的新问题/案例
- 更新现有案例(更改项目、领域、里程碑、优先级)
- 将案例分配给特定用户
- 列出用户的未结案件
- 获取具体案例的直接链接
- 按不同标准搜索案例
该服务器实现了模型上下文协议 (MCP)规范,允许任何与 MCP 兼容的 LLM 客户端使用它。
项目背景
该项目是在OpenAI 的 o3-mini-high 模型的帮助下启动的,该模型生成了一份全面的开发计划(请参阅代码库中的 DEVELOPMENT-PLAN.md)。该计划概述了使用 TypeScript 构建 FogBugz MCP 服务器的架构、工具和实现细节。
这份详细的规范为开发团队提供了蓝图,展示了人工智能如何在项目设计和规划的早期阶段有效辅助。该项目既是人工智能辅助开发的典范,也是通过MCP协议增强人工智能能力的工具。
安装
# Install from npm
npm install -g fogbugz-mcp
# Or use directly with npx
npx fogbugz-mcp <fogbugz-url> <api-key>
用法
基本用法
# Run with command line arguments
fogbugz-mcp https://yourcompany.fogbugz.com your-api-key
# Or use environment variables
export FOGBUGZ_URL=https://yourcompany.fogbugz.com
export TEST_FOGBUGZ_API_KEY=your-api-key
fogbugz-mcp
发展
# Clone the repository
git clone https://github.com/yourusername/fogbugz-mcp.git
cd fogbugz-mcp
# Install dependencies
npm install
# Create a .env file with your FogBugz credentials
echo "FOGBUGZ_URL=https://yourcompany.fogbugz.com" > .env
echo "TEST_FOGBUGZ_API_KEY=your-api-key" >> .env
# Run API explorer to test FogBugz API
npm run explore
# Run the development version of the server
npm run dev
# Run tests
npm test
# Build the project
npm run build
API 浏览器
该项目包括一个 API 探索工具,用于直接测试 FogBugz API 端点:
# Run all API tests
npm run explore
# Run a specific test (by index)
npm run explore 0 # Run the first test
MCP 工具
该服务器为 LLM 提供以下 MCP 工具:
fogbugz_create_case
- 创建一个新的 FogBugz 案例fogbugz_update_case
- 更新现有案例的字段fogbugz_assign_case
- 将案例分配给特定用户fogbugz_list_my_cases
- 列出分配给特定用户的案例fogbugz_search_cases
- 使用查询字符串搜索案例fogbugz_get_case_link
- 获取特定案例的直接链接
执照
国际学习中心