Mantis MCP Server

基本能力

产品定位

Mantis MCP Server 是一个用于与 Mantis Bug Tracker 系统集成的服务，通过 MCP 协议提供数据查询和分析功能。

核心功能

• 问题管理：获取问题列表（支持多种过滤条件），根据 ID 查询问题详情。
• 用户管理：根据用户名称查询用户，获取所有用户列表。
• 项目管理：获取项目列表。
• 统计分析：问题统计（支持多维度分析），分派统计（分析问题分派情况）。
• 效能优化：字段选择（减少回传资料量），分页处理（控制每次返回数量），自动资料压缩（大量资料时自动压缩）。
• 完整的错误处理和日志记录。

适用场景

• 需要与 Mantis Bug Tracker 系统集成的开发团队。
• 需要高效查询和分析 Mantis 数据的项目管理人员。
• 需要自动化处理 Mantis 数据的开发流程。

工具列表

1. 获取问题列表 (get_issues)：获取 Mantis 问题列表，可根据多个条件进行过滤。
2. 获取问题详情 (get_issue_by_id)：根据 ID 获取 Mantis 问题详情。
3. 查询用户 (get_user)：根据用户名称查询 Mantis 用户。
4. 获取项目列表 (get_projects)：获取 Mantis 项目列表。
5. 获取问题统计 (get_issue_statistics)：获取 Mantis 问题统计数据，根据不同维度进行分析。
6. 获取分派统计 (get_assignment_statistics)：获取 Mantis 问题分派统计数据，分析不同用户的问题分派情况。
7. 获取所有用户 (get_users)：用暴力法获取所有用户列表。

常见问题解答

• 如何获取 Mantis API Key：登录 MantisBT 账户，进入“我的账户” -> “API 令牌” -> “创建新令牌”。
• 如何配置环境变量：在项目根目录创建 .env 文件，设置 MANTIS_API_URL 和 MANTIS_API_KEY。
• 如何调试：在 .vscode/launch.json 中添加调试配置，使用 npm run watch 启动开发模式。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 运行以下命令安装依赖：

npm install

安装教程

1. 全局安装 mantis-mcp-server：

npm install -g mantis-mcp-server

1. 或者在项目中安装：

npm install mantis-mcp-server

配置

1. 在项目根目录创建 .env 文件，配置以下环境变量：

MANTIS_API_URL=https://your-mantis-instance.com/api/rest
MANTIS_API_KEY=your_api_key_here
NODE_ENV=development
LOG_LEVEL=info

调试方式

1. 启动开发模式：

npm run watch

1. 在 .vscode/launch.json 中添加调试配置，使用 VS Code 的调试功能启动服务。

代码结构

高阶函数

服务使用 withMantisConfigured 高阶函数来处理共用的检查逻辑，确保： - Mantis API 配置检查 - 统一的错误处理 - 标准化的响应格式 - 自动的日志记录

错误处理

完整的错误处理机制包括： - Mantis API 错误处理（包含 HTTP 状态码） - 通用错误处理 - 结构化的错误响应 - 详细的错误日志

日志

如果启用了文件日志（ENABLE_FILE_LOGGING=true），日志文件将保存在： - logs/mantis-mcp-server-combined.log：所有级别的日志 - logs/mantis-mcp-server-error.log：仅错误级别的日志

日志文件大小上限为 5MB，最多保留 5 个历史文件。

许可证

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