Mantis MCP Server

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

- 欄位選擇（減少回傳資料量）
- 分頁處理（控制每次返回數量）
- 自動資料壓縮（大量資料時自動壓縮）

To install Mantis Bug Tracker Integration for Claude Desktop automatically viaSmithery:

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

# 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

{ "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 系統中，編輯~/.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
- 重新載入 Cursor MCP
- 開啟命令面板（Windows: Ctrl+Shift+P, Mac: Cmd+Shift+P）

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

{ "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" } ] }

- projectId(可選): 專案 ID
- statusId(可選): 狀態 ID
- handlerId(可選): 處理人 ID
- reporterId(可選): 報告者 ID
- search(可選): 搜尋關鍵字
- pageSize(可選, 默認 20): 頁數大小
- page(可選, 默認 0): 分頁起始位置，從1開始
- select(可選): 選擇要返回的欄位，例如：['id', 'summary', 'description']。可用於減少回傳資料量

- projectId(可選): 專案 ID
- groupBy: 分組依據，可選值: 'status', 'priority', 'severity', 'handler', 'reporter'
- period(默認 'all'): 時間範圍，可選值: 'all', 'today', 'week', 'month'

- projectId(可選): 專案 ID
- includeUnassigned(默認 true): 是否包含未分派問題
- statusFilter(可選): 狀態過濾器，只計算特定狀態的問題

服務使用withMantisConfigured高階函數來處理共用的檢查邏輯，確保：

- Mantis API 配置檢查
- 統一的錯誤處理
- 標準化的回應格式
- 自動的日誌記錄

- Mantis API 錯誤處理（包含 HTTP 狀態碼）
- 通用錯誤處理
- 結構化的錯誤響應
- 詳細的錯誤日誌

# 安裝依賴 npm install # 構建 npm run build # 開發模式（監視變更） npm run watch # 運行 npm start

如果啟用了檔案日誌（ENABLE_FILE_LOGGING=true），日誌文件將保存在：

- logs/mantis-mcp-server-combined.log: 所有級別的日誌
- logs/mantis-mcp-server-error.log: 僅錯誤級別的日誌

@https://documenter.getpostman.com/view/29959/7Lt6zkP#c0c24256-341e-4649-95cb-ad7bdc179399

npm login --registry=https://registry.npmjs.org/npm run build npm publish --access public --registry=https://registry.npmjs.org/

Interact with Azure DevOps for managing projects, pipelines, and repositories.