Frequently Asked Questions about Mantis MCP Server

Q: What is the Mantis MCP Server? A: The Mantis MCP Server is a service based on the Model Context Protocol (MCP) that integrates with the Mantis Bug Tracker system. It allows users to query and analyze data from Mantis using the MCP protocol, facilitating integration with AI and automation tools.

Q: What are the key features of the Mantis MCP Server? A: Key features include issue management (fetching issue lists and details), user management, project management, statistical analysis (issue and assignment statistics), performance optimization (field selection, pagination, data compression), and comprehensive error handling and logging.

Q: How do I install the Mantis MCP Server? A: You can install the Mantis MCP Server using npm with the command npm install mantis-mcp-server. Detailed configuration steps are provided for Windows, macOS, and Linux.

Q: What is the Model Context Protocol (MCP)? A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It enables AI models to access and understand data from various sources, allowing them to perform tasks with greater accuracy and relevance.

Q: How do I configure the Mantis MCP Server? A: Configuration involves setting environment variables in a .env file, including the Mantis API URL, API key, and logging levels. Platform-specific configurations are required for Windows, macOS, and Linux, which involve modifying .cursormcp.json or ~/.cursor/mcp.json files.

Q: How do I obtain a MantisBT API Key? A: Log in to your MantisBT account, navigate to ‘My Account,’ select the ‘API Tokens’ tab, and create a new token. Copy the generated API token and paste it into the .env file.

Q: What are the benefits of using the Mantis MCP Server with UBOS? A: Integrating the Mantis MCP Server with UBOS allows you to create AI agents that automate bug resolution workflows, provide real-time bug status updates, and predict potential bugs, improving software quality and development processes.

Q: What kind of statistics can I retrieve with the Mantis MCP Server? A: You can retrieve issue statistics (grouped by status, priority, severity, handler, or reporter) and assignment statistics to analyze issue distribution among users.

Q: How can I optimize performance when retrieving data? A: You can optimize performance by selecting specific fields to return, using pagination to control the amount of data per request, and enabling automatic data compression for large datasets.

Q: Where are the log files stored? A: If file logging is enabled (ENABLE_FILE_LOGGING=true), log files are stored in the logs/ directory, including mantis-mcp-server-combined.log (all log levels) and mantis-mcp-server-error.log (error level only).

Q: What is the purpose of the withMantisConfigured function? A: The withMantisConfigured function is a higher-order function that handles shared checking logic, ensuring Mantis API configuration is valid, providing unified error handling, standardizing response formats, and automating logging.