FogBugz MCP Server

FogBugz MCP Server

site icon
2025.03.28 0
JavaScript项目管理AI辅助开发交流协作
FogBugz MCP Server 是一个基于模型上下文协议(MCP)的服务,旨在通过语言学习模型(如Claude)与FogBugz进行交互。该服务器允许LLMs执行多种FogBugz操作,包括创建和更新问题/案例、分配案例给特定用户、列出用户的开放案例、获取案例的直接链接以及根据多种条件搜索案例。该项目展示了AI在项目设计和规划初期的辅助作用,并通过MCP协议增强了AI的能力。
View on GitHub

Overview

基本能力

产品定位

FogBugz MCP Server 是一个中间件服务,连接语言学习模型(LLMs)和FogBugz项目管理工具,实现自动化任务管理。

核心功能

  • 创建新问题/案例(可选附件)
  • 更新现有案例(更改项目、区域、里程碑、优先级)
  • 将案例分配给特定用户
  • 列出用户的开放案例
  • 获取特定案例的直接链接
  • 根据多种条件搜索案例

适用场景

  • 自动化项目管理任务
  • 通过AI辅助进行案例跟踪和管理
  • 集成LLMs到现有的FogBugz工作流中

MCP工具列表

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

常见问题解答

  • 如何获取API密钥?需要从FogBugz账户设置中生成。
  • 如何运行开发版本?使用npm run dev命令。
  • 如何测试API端点?使用npm run explore命令。

使用教程

使用依赖

  • Node.js环境
  • npm包管理器

安装教程

# 从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

# 创建.env文件并添加FogBugz凭证
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测试
npm run explore

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

许可证

该项目遵循 ISC 开源许可条款。