Mantis

Mantis MCP Server provides MCP protocol access to a Mantis Bug Tracker, enabling you to query data, run analytics, and manage users, projects, and issues from any MCP client. It optimizes data delivery with selective fields, pagination, and optional compression, while offering robust error handling and logging.

How to use

You connect to the Mantis MCP Server from an MCP client by configuring the client to point to the server entry and using the available MCP endpoints to request information. Typical workflows include listing issues with optional filters, viewing issue details by ID, querying users, listing projects, and retrieving statistics for issues and assignments. You can tailor responses by selecting only the fields you need, and you can paginate large result sets to control payload size.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install the MCP server package locally for development or testing.

npm install mantis-mcp-server

Configuration and operational setup

Configure your Mantis API access and runtime options using environment variables in a .env file. The following options are used by the MCP server:

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

# Application configuration
NODE_ENV=development  # development, production, test
LOG_LEVEL=info       # error, warn, info, debug

# Cache configuration
CACHE_ENABLED=true
CACHE_TTL_SECONDS=300  # 5 minutes

# Logging configuration
LOG_DIR=logs
ENABLE_FILE_LOGGING=false

How to set up MCP in Cursor (Windows)

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

How to set up MCP in Cursor (macOS/Linux)

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

API 工具說明

The server exposes a set of tools to query and analyze Mantis data. The key capabilities include getting a list of issues with filters, fetching issue details by ID, querying users, listing projects, retrieving issue statistics, and obtaining assignment statistics. Additionally, you can optimize responses by selecting specific fields, paginating results, and enabling automatic data compression for large payloads.

開發與運行

Install dependencies, build, and run the server in development mode. These commands assume you are in the project directory where the package is defined.

npm install

# Build the project
npm run build

# Development mode with watch
npm run watch

# Run the server
npm start

日誌與監控

If file logging is enabled, logs are written to the logs directory with combined and error-only files. The combined log captures all levels, while the error log focuses on errors. Log file rotation limits each file to 5 MB and keeps up to 5 historical files.

許可與發布

License: MIT.

Available tools

get_issues

Fetches a list of Mantis issues with optional filters such as project, status, handler, reporter, search keywords, and pagination.

get_issue_by_id

Retrieves detailed information for a specific issue by its ID.

get_user

Queries a user by username.

get_projects

Retrieves the list of Mantis projects.

get_issue_statistics

Provides statistical analysis of issues with grouping by status, priority, severity, handler, or reporter over various periods.

get_assignment_statistics

Analyzes allocation of issues across users, including unassigned issues and optional status filtering.

get_users

Retrieves all users using a brute-force approach.