Servidor MCP @onozaty/redmine | PlugMCP
Pular para o conteúdo Do publicador
Documentação Redmine MCP Server
Model Context Protocol (MCP) server for Redmine that provides comprehensive access to the Redmine REST API.
Overview
This project is an MCP server that comprehensively covers Redmine's REST API . It allows you to operate Redmine from MCP clients (such as Claude Desktop).
Conecte qualquer ferramenta a qualquer agente. Diretório MCP para quem não escreve servidores.
Produto
Diretório
Desenvolvedores
Empresa
2026-11-17
Estrelas —
Ferramentas —
Disponibilidade —
Demonstration Here are example videos showing how to use the Redmine MCP server with Claude Desktop:
Creating an Issue This demonstration also uses the Playwright MCP for browser automation alongside the Redmine MCP server.
Getting Issue Information
Features
📋 Comprehensive API Coverage : Supports all functions available in Redmine's REST API
🔒 Read-Only Mode : Supports safe data reference mode
🔧 Tool Filtering : Control which tools are available using regex patterns
🏷️ Tool Annotations : Declares readOnlyHint so clients can tell read operations from write ones
Prerequisites
Getting Redmine API Key
Log in to Redmine with administrator privileges
Go to "Administration" → "Settings" → "API" tab
Check "Enable REST web service"
Generate "API access key" in personal settings
Configuration
Environment Variables The following environment variables are required (specified in MCP client configuration files):
REDMINE_URL (Required): Base URL of the Redmine instance
Example: https://redmine.example.com
REDMINE_API_KEY (Required): API key generated in Redmine
Set the API key obtained in prerequisites
REDMINE_MCP_READ_ONLY (Optional): Enable read-only mode
true: Read-only mode (disables data modification operations)
false or unset: Allow all operations (default)
REDMINE_MCP_TOOLS_ALLOW_PATTERN (Optional): Regex pattern to allow only matching tools
Example: ^get (enable only tools starting with "get")
If unset, all tools are allowed (subject to other settings)
REDMINE_MCP_TOOLS_DENY_PATTERN (Optional): Regex pattern to disable matching tools
Example: ^delete (disable all tools starting with "delete")
If unset, no tools are denied (subject to other settings)
Deny pattern takes priority over allow pattern
MCP Client Configuration
Using npx (Recommended for quick start) Add the following as MCP configuration for your AI agent:
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
Using Docker (Alternative) If you prefer using Docker:
{
"mcpServers": {
"redmine": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "REDMINE_URL=https://your-redmine.example.com",
"-e", "REDMINE_API_KEY=your-api-key-here",
"-e", "REDMINE_MCP_READ_ONLY=true",
"ghcr.io/onozaty/redmine-mcp-server:latest"
]
}
}
}
Enterprise environments requiring container isolation
Reproducible deployments across different systems
Environments where Node.js installation is restricted
Below are specific configuration methods for several MCP clients:
Claude Desktop Add the following to claude_desktop_config.json:
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
Claude Code In Claude Code, you can add MCP servers using the following commands:
claude mcp add redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server
claude mcp add -s project redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server
User configuration (global):
claude mcp add -s user redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server
Visual Studio Code Project configuration (.vscode/mcp.json):
{
"servers": {
"redmine": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
User configuration (settings.json):
{
"mcp": {
"servers": {
"redmine": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
}
Available Features
Main Features
Issues : Create, update, delete, search, and manage related issues
Projects : Create, update, delete, archive, and manage memberships
Users : Create, update, delete, and manage groups
Time Entries : Record, update, and delete time entries
Wiki : Create, update, delete pages, and manage versions
News : Create, update, and delete news
Files : Upload and download files
Attachments : Upload, download files, and get thumbnails
Queries : Execute saved queries
Custom Fields : Get and manage custom fields
Roles : Get and manage roles
Trackers : Get and manage trackers
Issue Statuses : Get and manage issue statuses
Search : Cross-search functionality
Read-Only Mode By setting REDMINE_MCP_READ_ONLY=true, you can disable data modification operations. This allows safe data reference.
Tool Filtering You can control which tools are available using the following environment variables:
REDMINE_MCP_TOOLS_ALLOW_PATTERN : Only tools whose names match this regex are enabled.
Example: ^get enables only read-oriented tools like getIssues, getProjects, etc.
REDMINE_MCP_TOOLS_DENY_PATTERN : Tools whose names match this regex are disabled.
Example: ^delete disables all delete operations.
When both are set, deny takes priority. These can also be combined with REDMINE_MCP_READ_ONLY.
Example: Allow only issue-related tools
"env": {
"REDMINE_MCP_TOOLS_ALLOW_PATTERN": "Issue"
}
Example: Disable all delete and archive operations
"env": {
"REDMINE_MCP_TOOLS_DENY_PATTERN": "^(delete|archive)"
}
Tool Annotations Every tool declares the readOnlyHint annotation, so clients do not have to guess from the tool name whether a call modifies data: it is true for read operations (getIssues, getProjects, ...) and false for the ones that create, update or delete. Clients that honour the annotation can, for instance, run read operations without asking the user for confirmation.
Available Tools
License
Author
Acknowledgments
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas Como instalo @onozaty/redmine? Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
@onozaty/redmine precisa de uma chave de API? Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte @onozaty/redmine usa? @onozaty/redmine roda localmente via stdio.
Quando @onozaty/redmine foi verificado pela última vez? Última verificação: 2026-11-17. MCP server for Redmine
As ferramentas têm descrição 0 de 6