convez.ai
MCP Server
weirdo-adam

redmine-mcp-server

weirdo-adam/redmine-mcp-server

Ver no GitHub
BomPluginScore · de 0 a 100

Standalone stdio MCP server for Redmine.

Instalação

$npx convez-ai weirdo-adam/redmine-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 2 meses
Versão
v0.1.1
Issues abertas
4
Contribuidores
3

README

A tradução para o português deste README ainda está na fila.

Redmine MCP Server

Standalone stdio Model Context Protocol server for Redmine.

It provides MCP tools for Redmine issues, projects, metadata, wiki pages, time entries, attachments, versions, relations, watchers, and Redmine Checklists.

Requirements

  • Rust 1.75 or newer, only for source builds
  • Redmine REST API enabled
  • Redmine API key with the required project permissions
  • Redmine Checklists plugin, only when checklist tools are used

Installation

Homebrew:

brew install weirdo-adam/tap/redmine-mcp-server

Local checkout:

scripts/install-local.sh

Usage

export REDMINE_BASE_URL="https://redmine.example.com"
export REDMINE_API_KEY="your-api-key"
export REDMINE_MCP_READ_ONLY=true
redmine-mcp-server

Development checkout:

export REDMINE_BASE_URL="https://redmine.example.com"
export REDMINE_API_KEY="your-api-key"
cargo run

The server communicates over newline-delimited JSON-RPC on stdin/stdout. Logs and diagnostics are written to stderr.

MCP Client Examples

Claude Code:

claude mcp add redmine \
  --transport stdio \
  --env REDMINE_BASE_URL=https://redmine.example.com \
  --env REDMINE_API_KEY=your-api-key \
  --env REDMINE_MCP_READ_ONLY=true \
  -- redmine-mcp-server

Codex CLI:

codex mcp add \
  --env REDMINE_BASE_URL=https://redmine.example.com \
  --env REDMINE_API_KEY=your-api-key \
  --env REDMINE_MCP_READ_ONLY=true \
  redmine -- redmine-mcp-server

Codex config.toml:

[mcp_servers.redmine]
command = "redmine-mcp-server"
args = []

[mcp_servers.redmine.env]
REDMINE_BASE_URL = "https://redmine.example.com"
REDMINE_API_KEY = "your-api-key"
REDMINE_MCP_READ_ONLY = "true"

Configuration

VariableRequiredDefaultDescription
REDMINE_BASE_URLYesnoneRedmine base URL.
REDMINE_API_KEYYesnoneRedmine REST API key.
REDMINE_MCP_READ_ONLYNofalseHide and reject write tools.
REDMINE_MCP_ENABLE_DELETESNofalseExpose destructive delete/remove tools.
REDMINE_TIMEOUT_MSNo30000HTTP request timeout in milliseconds.

Complete environment variables and client examples are documented in docs/client-configuration.md.

Development

scripts/check.sh
scripts/package-release.sh
scripts/package-binary.sh aarch64-apple-darwin macos aarch64

Source release archives are written to dist/:

redmine-mcp-server-<version>.tar.gz
redmine-mcp-server-<version>.tar.gz.sha256

Binary release archives use OS/CPU names:

redmine-mcp-server-<version>-<os>-<arch>.tar.gz
redmine-mcp-server-<version>-<os>-<arch>.tar.gz.sha256

Security

Permissions are determined by the configured Redmine API key. Use the least privileged key practical for the target project, and enable REDMINE_MCP_READ_ONLY=true when write operations are not required.

See SECURITY.md for vulnerability reporting.

Ver o original no GitHub

Relacionados