Mantis MCP Server

Mantis MCP Server 是一個基於 Model Context Protocol (MCP) 的服務，用於與 Mantis Bug Tracker 系統進行集成。它提供了一系列工具，允許用戶通過 MCP 協議查詢和分析 Mantis 系統中的數據。

功能

• 問題管理
  • 獲取問題列表（支持多種過濾條件）
  • 根據 ID 查詢問題詳情
• 用戶管理
  • 根據用戶名稱查詢用戶
  • 獲取所有用戶列表
• 專案管理
  • 獲取專案列表
• 統計分析
  • 問題統計（支持多維度分析）
  • 分派統計（分析問題分派情況）
• 效能優化
  • 欄位選擇（減少回傳資料量）
  • 分頁處理（控制每次返回數量）
  • 自動資料壓縮（大量資料時自動壓縮）
• 完整的錯誤處理和日誌記錄

安裝

Installing via Smithery

To install Mantis Bug Tracker Integration for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kfnzero/mantis-mcp-server --client claude

Manual Installation

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

MantisBT API Key 獲取方式

1. 登入您的 MantisBT 帳戶
2. 點擊右上角的用戶名稱，選擇「我的帳戶」
3. 切換到「API 令牌」標籤
4. 點擊「創建新令牌」按鈕
5. 輸入令牌名稱（例如：MCP Server）
6. 複製生成的 API 令牌，並將其貼入 .env 文件的 MANTIS_API_KEY 設置中

MCP 配置

全域安裝

首先，需要全域安裝 mantis-mcp-server：

npm install -g mantis-mcp-server

Windows 配置

在 Windows 系統中，編輯 %USERPROFILE%\.cursor\mcp.json（通常在 C:\Users\你的用戶名\.cursor\mcp.json），添加以下配置：

{
  "mcpServers": {
    "mantis-mcp-server": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "%APPDATA%\\npm\\node_modules\\mantis-mcp-server\\dist\\index.js"
      ],
      "env": {
        "MANTIS_API_URL": "YOUR_MANTIS_API_URL",
        "MANTIS_API_KEY": "YOUR_MANTIS_API_KEY",
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}

macOS/Linux 配置

在 macOS 或 Linux 系統中，編輯 ~/.cursor/mcp.json，添加以下配置：

{
  "mcpServers": {
    "mantis-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mantis-mcp-server@latest",
      ],
      "env": {
        "MANTIS_API_URL": "YOUR_MANTIS_API_URL",
        "MANTIS_API_KEY": "YOUR_MANTIS_API_KEY",
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}

注意：在 macOS/Linux 中，我們使用 npx 來運行最新版本的 mantis-mcp-server，這樣可以確保始終使用最新版本，不需要全域安裝。

環境變數說明

• MANTIS_API_URL: 您的 Mantis API URL
• MANTIS_API_KEY: 您的 Mantis API 金鑰
• NODE_ENV: 執行環境，建議設置為 "production"
• LOG_LEVEL: 日誌級別，可選值：error、warn、info、debug

驗證配置

配置完成後，您可以：

1. 重新載入 Cursor MCP
2. 開啟命令面板（Windows: Ctrl+Shift+P, Mac: Cmd+Shift+P）

在 Cursor 中設定

1. 在 .vscode/mcp.json 中添加以下配置：

{
  "servers": {
    "mantis-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"]
    }
  }
}

2. 在 .vscode/launch.json 中添加以下配置用於除錯：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug MCP Server",
      "skipFiles": ["<node_internals>/**"],
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "runtimeExecutable": "npx",
      "runtimeArgs": [
        "-y",
        "@modelcontextprotocol/inspector",
        "node",
        "dist/index.js"
      ],
      "console": "integratedTerminal",
      "preLaunchTask": "npm: watch",
      "serverReadyAction": {
        "action": "openExternally",
        "pattern": "running at (https?://\\S+)",
        "uriFormat": "%s?timeout=60000"
      },
      "envFile": "${workspaceFolder}/.env"
    }
  ]
}

API 工具說明

1.

... View full README on GitHub