Labsco
tamu960925 logo

Redmine

from tamu960925

An MCP server for interacting with the Redmine project management system.

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#devops#security#monitoring

Redmine MCP Server

A Model Context Protocol (MCP) server for Redmine integration, built with TypeScript following TDD methodology. This server allows AI assistants to interact with Redmine instances to manage issues, projects, and users with comprehensive security and monitoring features.

Features

  • Issue Management: Create, read, update, and list issues
  • Project Management: List and view project details
  • User Management: List and view user information
  • Error Handling: Comprehensive error handling with meaningful error messages
  • Type Safety: Full TypeScript implementation with proper type definitions

Available Tools

Issue Tools

  • list-issues: List issues with optional filtering

    • Parameters: project_id, status_id, assigned_to_id, limit, offset

  • create-issue: Create a new issue

    • Required: project_id, subject
    • Optional: description, tracker_id, status_id, priority_id, assigned_to_id

  • get-issue: Get details of a specific issue

    • Required: id

  • update-issue: Update an existing issue

    • Required: id
    • Optional: subject, description, status_id, priority_id, assigned_to_id, done_ratio

Project Tools

  • list-projects: List all projects

  • get-project: Get details of a specific project

    • Required: id (can be numeric ID or string identifier)

User Tools

  • list-users: List all users

  • get-user: Get details of a specific user

    • Required: id

Development

Running Tests

npm test

Running Tests with Coverage

npm run test:coverage

Running in Watch Mode

npm run test:watch

Linting

npm run lint

Type Checking

npm run typecheck

Clean Build Directory

npm run clean

API Reference

RedmineClient

The core client for interacting with Redmine's REST API.

const client = new RedmineClient({
  baseUrl: 'https://redmine.example.com',
  apiKey: 'your-api-key'
});

RedmineMcpServer

The MCP server that exposes Redmine functionality as MCP tools.

const server = new RedmineMcpServer({
  baseUrl: 'https://redmine.example.com',
  apiKey: 'your-api-key'
});

await server.start();

Error Handling

The server provides comprehensive error handling for common scenarios:

  • Authentication errors (401): Invalid API key
  • Authorization errors (403): Insufficient permissions
  • Not found errors (404): Resource doesn't exist
  • Validation errors (422): Invalid data provided
  • Server errors (500): Internal server issues
  • Network errors: Connection timeouts and network issues
  • Input validation: Client-side validation with detailed error messages

Logging

The server includes structured logging with configurable levels:

  • DEBUG: Detailed execution information and request/response data
  • INFO: General operational information (default)
  • WARN: Warning conditions that don't affect operation
  • ERROR: Error conditions that require attention

Configure the log level using the LOG_LEVEL environment variable:

export LOG_LEVEL="debug"  # For development
export LOG_LEVEL="info"   # For production (default)
export LOG_LEVEL="error"  # For minimal logging