MantisBT MCP Server

MantisBT MCP Server

A Model Context Protocol (MCP) server for accessing MantisBT objects via its REST API. Built with TypeScript, FastMCP, Axios, and Zod for robust, type-safe development.

Features

This MCP server provides tools to interact with MantisBT through the following capabilities:

Issues

• getIssue - Get an issue by ID
• getIssues - Get a list of issues with pagination
• createIssue - Create a new issue

Projects

• getProject - Get a project by ID
• getProjects - Get all projects

Users

• getCurrentUser - Get the current authenticated user

Issue Notes

• createIssueNote - Create a note for an issue

Setup

1. Install Dependencies
   npm install
2. Configure Environment Copy .env and update with your MantisBT instance details:
   API_URL=https://your-mantisbt-instance.com API_TOKEN=your-api-token-here
3. Build the Project
   npm run build
4. Run the Server
   npm run dev

Project Structure

Development

• TypeScript: Strongly typed throughout
• Zod: Runtime validation for API requests/responses
• Axios: HTTP client for REST API calls
• FastMCP: MCP server framework
• Error Handling: Consistent error handling across all controllers

API Integration

The server uses the MantisBT REST API with:

• Bearer token authentication via Authorization header
• Zod schemas for request/response validation
• Proper error handling and user-friendly error messages
• Type-safe API responses

Available Scripts

• npm run dev - Start development server
• npm run build - Build TypeScript to JavaScript
• npm run test - Run tests (when implemented)
• npm run lint - Run ESLint

License

MIT