MantisBT MCP服务器

英语 · 多伊奇

一、 模型上下文协议（MCP） 集成了 MantisBT REST API Claude Code和其他mcp客户端直接从编辑器读取、创建和更新问题。

要求

• Node.js≥22
• 启用REST API的MantisBT安装（2.23+版本）
• MantisBT API令牌(创建下 我的帐户→API令牌）

安装

通过npx（推荐）：

将......添加到...... ~/.claude/claude_desktop_config.json （Claude Desktop）或你当地的 claude_desktop_config.json (Claude代码):

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": ["-y", "@dpesch/mantisbt-mcp-server"],
      "env": {
        "MANTIS_BASE_URL": "https://your-mantis.example.com/api/rest",
        "MANTIS_API_KEY": "your-api-token"
      }
    }
  }
}

当地的构建:

git clone https://codeberg.org/dpesch/mantisbt-mcp-server
cd mantisbt-mcp-server
npm run init
npm run build

{
  "mcpServers": {
    "mantisbt": {
      "command": "node",
      "args": ["/path/to/mantisbt-mcp-server/dist/index.js"],
      "env": {
        "MANTIS_BASE_URL": "https://your-mantis.example.com/api/rest",
        "MANTIS_API_KEY": "your-api-token"
      }
    }
  }
}

配置

环境变量

限制提供的工具

两个envars减少了提供给模型的工具表面-有助于保持模型上下文更短，并防止意外的破坏性操作：

• MANTIS_TOOLSETS -只包含列出的组（逗号分隔，不区分大小写）
• MANTIS_DISABLE_DESTRUCTIVE=true -额外隐藏 delete_issue， delete_note， delete_version， remove_relationship, remove_monitor 不管活跃的群体是什么

隐藏工具不列出，调用时返回“Tool…not found”。

¹隐藏于 MANTIS_DISABLE_DESTRUCTIVE=true ·†已弃用，在2.0.0·²中移除 MANTIS_SEARCH_ENABLED=true;没有 search 组搜索模块根本没有启动

弃用的工具总是和它们的替换工具属于同一个组——禁用一个组会同时隐藏旧的和新的名称。

A -分诊设置 （问题、注释和元数据；无破坏性操作）：

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": ["-y", "@dpesch/mantisbt-mcp-server"],
      "env": {
        "MANTIS_BASE_URL": "https://your-mantis.example.com/api/rest",
        "MANTIS_API_KEY": "your-api-token",
        "MANTIS_TOOLSETS": "issues,notes,meta",
        "MANTIS_DISABLE_DESTRUCTIVE": "true"
      }
    }
  }
}

使用实例B - all组，delete-protection only （41个默认工具中的36个）：

{
  "mcpServers": {
    "mantisbt": {
      "command": "npx",
      "args": ["-y", "@dpesch/mantisbt-mcp-server"],
      "env": {
        "MANTIS_BASE_URL": "https://your-mantis.example.com/api/rest",
        "MANTIS_API_KEY": "your-api-token",
        "MANTIS_DISABLE_DESTRUCTIVE": "true"
      }
    }
  }
}

可用的工具

问题

笔记

附件

的关系

监控

标签

项目

语义搜索 (可选)

而不是精确的关键字匹配，语义搜索理解 意义 在查询后面。用通俗易懂的语言提问——即使措辞不匹配，搜索引擎也能找到概念上相关的问题。

• “重置密码后登录失败” -查找有关认证边缘情况的问题
• “结帐页面的性能问题” -表面相关的报告，而不管使用的确切术语
• 发票清单上的重复条目 -捕获被描述为“显示两次”、“重复记录”等问题。

嵌入模型（~ 80mb）完全运行 离线 -没有OpenAI密钥，没有外部API。它在第一次启动时下载一次，并在本地缓存。问题在每次服务器启动时都被增量索引（只有新的和更新的问题被重新索引）。当多个客户端会话同时启动服务器时，只有其中一个会话同步共享索引。该模型在第一次使用时加载，并在10分钟后再次卸载，没有嵌入，因此空闲会话不会占用其内存（每个服务器进程约0.9 GB）。

激活与 MANTIS_SEARCH_ENABLED=true.

选择哪个后端？

从……开始 vectra． 切换到 sqlite-vec 如果索引或查询时间明显变慢。

npm install sqlite-vec better-sqlite3
# then set MANTIS_SEARCH_BACKEND=sqlite-vec

元数据与系统

使用令牌

服务器自己处理计数和字段投影——模型接收一个紧凑的摘要，而不是读取原始问题列表。在2026-10-31对MantisBT 2.28安装进行测试（604个问题，5个问题有很长的描述/注释）：

¹ list_issues 当客户端过滤器处于活动状态时，最多扫描500个问题，因此这个“before”值被低估了。

记号估计为字符/ 4。要在你自己的实例上复制（需要git签出，不能通过npx）：

MANTIS_BASE_URL=… MANTIS_API_KEY=… \
  BENCHMARK_PROJECT_ID=12 BENCHMARK_ISSUE_IDS=101,102,103,104,105 \
  npm run benchmark

证书也可能来自 .env.local.

可用的资源

MCP资源是可uri寻址的只读数据，客户端无需调用工具即可直接获取。它们是继工具和提示符之后的第三个MCP原语。请注意，在MCP客户端中，资源支持的实现范围不如工具广泛——请查看客户端的文档。

可用的提示

MCP提示模板是对话启动器，它指示LLM收集结构化输入，然后调用适当的工具。它们本身并不是工具——它们启动了一个被引导的工作流。

HTTP方式

作为独立服务器使用（例如在远程设置中）。 MCP_HTTP_TOKEN 是 要求 在HTTP模式下-服务器拒绝启动没有它：

MCP_HTTP_TOKEN=secret MANTIS_BASE_URL=... MANTIS_API_KEY=... \
  TRANSPORT=http PORT=3456 node dist/index.js

# With explicit bind address (required for Docker/remote):
# MCP_HTTP_TOKEN=secret MANTIS_BASE_URL=... MANTIS_API_KEY=... \
#   TRANSPORT=http PORT=3456 MCP_HTTP_HOST=0.0.0.0 node dist/index.js

每一个 /mcp 请求必须发送 Authorization: Bearer <token>． 通过HTTP, upload_file的 file_path 被禁用，除非 MANTIS_UPLOAD_DIR 设置-使用 content （Base64）参数。

健康检查: GET http://localhost:3456/health （总是公开的，不需要令牌）

文档

• 食谱 -面向工具的食谱，包括所有注册工具的复制粘贴参数示例
• 用法示例 -日常用例的自然语言提示示例（不需要工具名称）

开发

npm run init         # First-time setup: install deps, git hooks, typecheck
npm run build        # Compile TypeScript → dist/
npm run typecheck    # Type check without output
npm run dev          # Watch mode for development
npm test             # Run tests (vitest)
npm run test:watch   # Run tests in watch mode
npm run test:coverage # Coverage report
npm run benchmark    # Token benchmark against a live MantisBT (see Token usage above)

许可证

MIT -见 许可证

贡献

贡献欢迎!请阅读 CONTRIBUTING.md. 存储库: codeberg.org/dpesch/mantisbt-mcp-server