Redmine MCP Server

🚀 Redmine MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Redmine for focused and transparent project management.

🚀 Quick Start

The Redmine MCP Server serves as a bridge between AI assistants and Redmine, enabling AI to:

• Create and update issues with correct categorization.
• Manage wiki pages and documents.
• Track project status and progress.
• Follow defined processes to ensure consistency.

By using this MCP server, you can ensure that AI work is focused, well - documented, and fully transparent to human team members.

✨ Features

Resource Capabilities

• Issues: Access Redmine issues with filtering and search capabilities.
• Projects: Access project data, categories, and status.
• Wiki: Access documentation resources on wiki pages.

Tool Capabilities

• create_issue: Create new issues with correct categorization.
• update_issue: Update the status changes and remarks of existing issues.
• create_wiki: Create or update wiki pages for documentation.
• get_project_status: Get project status summaries and statistics.

Prompt Capabilities

• issue_template: A template for creating well - structured issues.
• wiki_template: A template for creating well - structured wiki pages.

📦 Installation

Prerequisites

• Python 3.9+
• Flask
• A Redmine instance with API access
• Claude Desktop or other MCP - compatible AI assistants

Steps

1. Clone the repository:

   git clone https://github.com/yourusername/redmine-mcp-server.git
   cd redmine-mcp-server
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Configure the server:

   cp config.yaml.example config.yaml
   # Edit config.yaml with your Redmine URL and API token
   

💻 Usage Examples

Basic Usage

Run the Server

Start the server using the following command:

python main.py

The server runs on the default port 5000.

Docker Deployment

Build and run the Docker container:

docker build -t redmine-mcp-server .
docker run -d -p 5000:5000 -e REDMINE_API_KEY=your_api_key -e REDMINE_URL=http://localhost:3000 redmine-mcp-server

Configure Claude Desktop

Add the following content to your Claude Desktop MCP configuration:

{
  "mcps": {
    "redmine": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REDMINE_API_KEY",
        "-e",
        "REDMINE_URL",
        "redmine-mcp-server"
      ]
    }
  }
}

📚 Documentation

API Reference

Resources

• GET /mcp
  • Description: Returns the status of the MCP server.
  • Method: GET
  • URL: /mcp

Status

• GET /projects/{project_id}
  • Description: Returns the status information of the specified project.
  • Method: GET
  • URL: /projects/{project_id}

Configuration Options

The following environment variables can be used to configure the MCP server:

Process Advantages

1. Focus: AI work is executed by category and process, ensuring efficiency.
2. Well - documented: All AI actions are logged for review.
3. Transparency: Team members can easily view and contribute to AI work.
4. Collaboration: Human team members can directly interact with AI work in Redmine.
5. Progress Tracking: Project managers can track the progress of AI tasks through Redmine.

📄 License

This project is licensed under the MIT License.

🤝 Contributing

Any contributions are welcome! Please feel free to submit a Pull Request.