Mcp For Redmine

Name: Mcp For Redmine
Author: chspower1

@chspower1

关于 Mcp For Redmine

This project is a Model-Context-Protocol (MCP) server for interacting with Redmine. With an MCP-compatible client, you can easily manage Redmine projects, issues, users, and time entries.

#mcp-for-redmine #redmine #project-management

基本信息

分类

其他

传输方式

stdio

发布者

chspower1

提交者

조호성

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-for-redmine": {
      "command": "npx",
      "args": [
        "-y",
        "@chspower1/mcp-for-redmine@latest"
      ],
      "env": {
        "REDMINE_BASE_URL": "https://your.redmine.tld",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Mcp For Redmine?

Mcp For Redmine is a Model-Context-Protocol (MCP) server that lets MCP-compatible clients manage Redmine projects, issues, users, and time entries. It connects to any Redmine instance via its REST API and is intended for developers and administrators who want to interact with Redmine through AI assistants or custom tools.

How to use Mcp For Redmine?

Install and configure the server by adding it as an MCP server in your client (Cursor, Claude Desktop, Claude Code, Gemini CLI, or OpenAI Codex). Provide your Redmine base URL and API key via environment variables (REDMINE_BASE_URL and REDMINE_API_KEY) or CLI flags (--url, --api-key). The server runs via npx -y @chspower1/mcp-for-redmine@latest using stdio transport.

Key features of Mcp For Redmine

Manage users: create, get, list, update, delete.
Manage projects: CRUD plus archive/unarchive operations.
Manage issues: full CRUD with support for custom fields and attachments.
Manage time entries: list, get, create, update, delete.
Alpha APIs for memberships, versions, wiki pages, queries, files, attachments, issue relations, and more.
Pagination and association expansion on list tools.

Use cases of Mcp For Redmine

Automate issue creation or updates from an AI assistant.
Retrieve project and user details to answer questions without manual Redmine navigation.
Synchronize time entries or project data between Redmine and other tools.
Bulk operations on issues, versions, or wiki pages via natural language commands.

FAQ from Mcp For Redmine

What transport does Mcp For Redmine support?

Currently only stdio (standard input/output) transport is supported.

What are the requirements to run Mcp For Redmine?

Node.js 18 or higher and a Redmine API key. The compatibility baseline is Redmine 6.0.6.

How do I configure the Redmine URL and API key?

You can set REDMINE_BASE_URL (or REDMINE_URL) and REDMINE_API_KEY (or REDMINE_TOKEN) as environment variables, use CLI flags --url and --api-key, or place them in a .env file. For most clients, add them under env in the MCP server config.

Does the server support file attachments?

Yes. Use attachments_upload to upload a Base64 file and get a token, then include the token in the uploads field of issues_create/update or wiki_pages_create_or_update.

What should I do if I see "Redmine URL is required" or authentication errors?

Ensure your URL and API key are correctly set using one of the configuration methods. For security, use environment variables. Verify your API key permissions and network connectivity.