MCP Redmine

Servidor MCP em TypeScript para consultar o Redmine. A primeira tool disponível é list_projects.

Pré-requisitos e instalação

Requer Node.js 20 ou superior.

npm install
cp .env.example .env

Preencha .env sem incluir credenciais no repositório:

REDMINE_URL=https://redmine.exemplo.com
REDMINE_API_KEY=sua-chave

Uso

Para iniciar com dados simulados, sem configurar variáveis de ambiente ou acessar o Redmine:

npm run start-dev

Esse modo também usa stdio, exibe quatro projetos estáveis de exemplo e não envia nenhuma requisição HTTP. Ele é destinado apenas ao desenvolvimento local.

Para conectar à API real do Redmine, preencha .env e execute:

npm run build
npm start

O servidor usa transporte stdio; configure o cliente MCP para executar node /caminho/para/mcpRedmine/dist/server.js, com REDMINE_URL e REDMINE_API_KEY no ambiente do processo.

Execute validações com:

npm run check
npm test

Tool list_projects

Entrada: {}.

Exemplo de resposta:

{
  "projects": [{
    "id": 12,
    "name": "Aplicativo Mobile",
    "identifier": "aplicativo-mobile",
    "description": "Projeto responsável pelo aplicativo mobile.",
    "status": "active",
    "parent": { "id": 3, "name": "Produtos Digitais" }
  }],
  "totalCount": 1
}

O servidor busca todas as páginas internamente e não expõe detalhes de paginação, credenciais ou campos internos do Redmine.