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 令牌」标签，点击「创建新令牌」按钮，输入令牌名称，复制生成的 API 令牌。
• 如何验证配置：配置完成后，可以重新载入 Cursor MCP 或开启命令面板进行验证。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 确保已安装 Mantis Bug Tracker 系统并获取 API Key。

安装教程

npm install mantis-mcp-server

配置

1. 在项目根目录建立 .env 文件：

# Mantis API 配置
MANTIS_API_URL=https://your-mantis-instance.com/api/rest
MANTIS_API_KEY=your_api_key_here

# 应用配置
NODE_ENV=development  # development, production, test
LOG_LEVEL=info       # error, warn, info, debug

# 快取配置
CACHE_ENABLED=true
CACHE_TTL_SECONDS=300  # 5分钟

# 日志配置
LOG_DIR=logs
ENABLE_FILE_LOGGING=false

调试方式

1. 运行服务：

npm start

1. 查看日志文件（如果启用了文件日志）：
2. logs/mantis-mcp-server-combined.log: 所有级别的日志
3. logs/mantis-mcp-server-error.log: 仅错误级别的日志

许可证

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