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

src/
  controllers/      # Entity classes (Issues, Projects, Users, etc.)
  tools/            # MCP tool definitions
  types/            # Zod schemas and TypeScript types
  config/           # Configuration utilities
  main.ts           # Server entry point

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