Redmine MCP Server
stdio-based Model Context Protocol server that wraps a Redmine instance through its REST API (*.json endpoints). It runs as a separate Node.js process; no changes to the Redmine Rails app are required.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
REDMINE_BASE_URL=<value> REDMINE_API_KEY=<secret> REDMINE_IMPERSONATE_USER=<value> REDMINE_READONLY=<value> REDMINE_ALLOW_RAW_REQUEST=<value> REDMINE_HTTP_TIMEOUT_MS=<value> REDMINE_MAX_PAGES=<value> REDMINE_MAX_DOWNLOAD_BYTES=<value> claude mcp add io.github.nikhilprasad-r-redmine-mcp-connector -- npx -y redmine-mcp-connector@1.0.1在終端機中執行。
{ "mcpServers": { "io.github.nikhilprasad-r-redmine-mcp-connector": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "REDMINE_BASE_URL": "<value>", "REDMINE_API_KEY": "<secret>", "REDMINE_IMPERSONATE_USER": "<value>", "REDMINE_READONLY": "<value>", "REDMINE_ALLOW_RAW_REQUEST": "<value>", "REDMINE_HTTP_TIMEOUT_MS": "<value>", "REDMINE_MAX_PAGES": "<value>", "REDMINE_MAX_DOWNLOAD_BYTES": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
stdio-based Model Context Protocol server that wraps a Redmine instance through its REST API (*.json endpoints). It runs as a separate Node.js process; no changes to the Redmine Rails app are required.
stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.
REDMINE_BASE_URLNo install needed for normal use — coding agents launch it on demand via npx:
npx -y redmine-mcp-connector
See CONNECTING.md for exact setup instructions for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code, Zed, and any other MCP client, plus a local-build and Docker alternative.
To hack on the server itself, clone this repo instead:
npm install
npm run build
Environment variables (see .env.example):
REDMINE_BASE_URL=https://your-redmine.example.com REDMINE_API_KEY=secret npm start
# or during development:
REDMINE_BASE_URL=... REDMINE_API_KEY=... npm run dev
Full per-client instructions (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code, Zed, and generic MCP clients) live in CONNECTING.md. Quick example (Claude Desktop / Cursor / Windsurf all share this shape):
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "redmine-mcp-connector"],
"env": {
"REDMINE_BASE_URL": "https://redmine.example.com",
"REDMINE_API_KEY": "your_api_key_here"
}
}
}
}
Naming: redmine_<resource>_<action>.
Issues: redmine_issues_list, redmine_issue_get, redmine_issue_create, redmine_issue_update, redmine_issue_add_comment, redmine_issue_delete (requires confirm: true), watchers add/remove, relations list/add/remove.
Projects: redmine_projects_list, redmine_project_get, create/update/archive/unarchive/delete (confirm for delete).
Users: redmine_current_user, redmine_users_list, redmine_user_get, create/update/delete (confirm for delete).
Time entries: list/get/create/update/delete (confirm for delete).
News: list/get/create/update/delete (confirm for delete).
Wiki: list pages, get page, create/update (PUT), delete (confirm).
Versions & categories: versions CRUD (confirm on delete), issue categories CRUD (confirm on delete).
Queries & metadata: redmine_queries_list, redmine_enumerations_list, redmine_trackers_list, redmine_issue_statuses_list, redmine_roles_list, redmine_role_get, redmine_custom_fields_list.
Groups (read-only): redmine_groups_list, redmine_group_get.
Memberships: list/create/update/delete (confirm on delete).
Attachments & search: redmine_search, attachment get/update/delete/upload/download (download returns base64, size-capped).
Repository (limited REST in stock Redmine): redmine_repository_revision_link_issue, redmine_repository_revision_unlink_issue (confirm). Listing repositories/revisions over JSON is not exposed by core Redmine; use redmine_request if you enable it, or plugins.
Escape hatch: redmine_request — only if REDMINE_ALLOW_RAW_REQUEST=true; DELETE requires confirm: true.
confirm: true where noted.REDMINE_READONLY=true for read-only deployments.Build a local image:
docker build -t redmine-mcp-server:local .
Run it (stdio MCP server):
docker run --rm -i -e REDMINE_BASE_URL="https://redmine.example.com" -e REDMINE_API_KEY="your_api_key_here" redmine-mcp-server:local
Use this image in MCP config:
{
"mcpServers": {
"redmine": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "REDMINE_BASE_URL",
"-e", "REDMINE_API_KEY",
"docker.io/<docker-user>/redmine-mcp-server:latest"
],
"env": {
"REDMINE_BASE_URL": "https://redmine.example.com",
"REDMINE_API_KEY": "your_api_key_here"
}
}
}
}
docker login
docker buildx create --name redmine-mcp-builder --use --bootstrap
export IMAGE=docker.io/<docker-user>/redmine-mcp-server
export TAG=1.0.0
docker buildx build --platform linux/amd64,linux/arm64 -t $IMAGE:$TAG -t $IMAGE:latest --push .
npm run lint
npm test
Contributions are welcome.
CONNECTING.md for detailed client setup instructions.CONTRIBUTING.md for local setup, coding expectations, and PR workflow.CODE_OF_CONDUCT.md to keep collaboration respectful and inclusive.SUPPORT.md for help channels and what details to include.SECURITY.md.REGISTRY_PUBLISHING.md.GPL-2.0-or-later (same family as Redmine).
stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.
{ "mcpServers": { "io.github.nikhilprasad-r-redmine-mcp-connector": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "REDMINE_BASE_URL": "<value>", "REDMINE_API_KEY": "<secret>", "REDMINE_IMPERSONATE_USER": "<value>", "REDMINE_READONLY": "<value>", "REDMINE_ALLOW_RAW_REQUEST": "<value>", "REDMINE_HTTP_TIMEOUT_MS": "<value>", "REDMINE_MAX_PAGES": "<value>", "REDMINE_MAX_DOWNLOAD_BYTES": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:REDMINE_BASE_URL, REDMINE_API_KEY, REDMINE_IMPERSONATE_USER, REDMINE_READONLY, REDMINE_ALLOW_RAW_REQUEST, REDMINE_HTTP_TIMEOUT_MS, REDMINE_MAX_PAGES, REDMINE_MAX_DOWNLOAD_BYTES。
Redmine MCP Connector 透過 stdio 在本機執行。
上次檢查時間:2026-11-09。 stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.