MantisBT MCP Server

claude mcp add mantisbt-mcp-server -e 'MANTIS_BASE_URL=<MANTIS_BASE_URL>' -e 'MANTIS_API_KEY=<your mantis_api_key>' -e 'MANTIS_USE_INDEX_PHP=false' -e 'MANTIS_CACHE_DIR=<MANTIS_CACHE_DIR>' -e 'MANTIS_CACHE_TTL=3600' -e 'TRANSPORT=stdio' -e 'PORT=3000' -e 'MCP_HTTP_HOST=127.0.0.1' -e 'MCP_HTTP_TOKEN=<your mcp_http_token>' -e 'MANTIS_SEARCH_ENABLED=false' -e 'MANTIS_SEARCH_BACKEND=vectra' -e 'MANTIS_SEARCH_DIR=<MANTIS_SEARCH_DIR>' -e 'MANTIS_SEARCH_MODEL=Xenova/paraphrase-multilingual-MiniLM-L12-v2' -e 'MANTIS_SEARCH_THREADS=1' -e 'MANTIS_UPLOAD_DIR=<MANTIS_UPLOAD_DIR>' -- npx -y @dpesch/mantisbt-mcp-server@1.15.0

{
    "mcpServers": {
        "mantisbt-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@dpesch/mantisbt-mcp-server@1.15.0"
            ],
            "env": {
                "MANTIS_BASE_URL": "<MANTIS_BASE_URL>",
                "MANTIS_API_KEY": "<your mantis_api_key>",
                "MANTIS_USE_INDEX_PHP": "false",
                "MANTIS_CACHE_DIR": "<MANTIS_CACHE_DIR>",
                "MANTIS_CACHE_TTL": "3600",
                "TRANSPORT": "stdio",
                "PORT": "3000",
                "MCP_HTTP_HOST": "127.0.0.1",
                "MCP_HTTP_TOKEN": "<your mcp_http_token>",
                "MANTIS_SEARCH_ENABLED": "false",
                "MANTIS_SEARCH_BACKEND": "vectra",
                "MANTIS_SEARCH_DIR": "<MANTIS_SEARCH_DIR>",
                "MANTIS_SEARCH_MODEL": "Xenova/paraphrase-multilingual-MiniLM-L12-v2",
                "MANTIS_SEARCH_THREADS": "1",
                "MANTIS_UPLOAD_DIR": "<MANTIS_UPLOAD_DIR>"
            }
        }
    }
}

متغيرات البيئة

• MANTIS_BASE_URL إلزامي Base URL of the MantisBT REST API, e.g. https://your-mantis.example.com/api/rest
• MANTIS_API_KEY إلزامي سري MantisBT API key (Profile → API Tokens in MantisBT)
• MANTIS_USE_INDEX_PHP Use /api/rest/index.php/ for MantisBT installations without URL rewriting. Detected automatically when MANTIS_BASE_URL ends with /api/rest/index.php
• MANTIS_CACHE_DIR Directory for the metadata cache. Defaults to ~/.cache/mantisbt-mcp
• MANTIS_CACHE_TTL Metadata cache TTL in seconds. Default: 3600 (1 hour)
• TRANSPORT Transport mode. 'stdio' for local use (default), 'http' for remote/team deployments
• PORT HTTP port when TRANSPORT=http. Default: 3000
• MCP_HTTP_HOST Bind address when TRANSPORT=http. Default: 127.0.0.1 (local only). Use 0.0.0.0 for Docker/remote.
• MCP_HTTP_TOKEN سري Optional Bearer token to protect the /mcp endpoint when TRANSPORT=http
• MANTIS_SEARCH_ENABLED Enable offline semantic search (requires ~80 MB model download on first use)
• MANTIS_SEARCH_BACKEND Vector store backend for semantic search. 'vectra' (default, pure JS) or 'sqlite-vec' (faster for >10k issues)
• MANTIS_SEARCH_DIR Directory for the semantic search index. Defaults to ~/.cache/mantisbt-mcp/search
• MANTIS_SEARCH_MODEL Hugging Face model for embeddings. Default: Xenova/paraphrase-multilingual-MiniLM-L12-v2
• MANTIS_SEARCH_THREADS ONNX inference threads for the embedding model. Default: 1
• MANTIS_UPLOAD_DIR If set, restricts file uploads to this directory (path traversal protection)