Сервер Redmine MCP

Это реализация сервера Model Context Protocol (MCP) для Redmine. Он интегрируется с REST API Redmine для предоставления информации о тикетах и проектах LLM.

Функции

Поддерживает стабильные ресурсы из Redmine REST API:

Проблемы (1.0~)
Проекты (1.0~)
Пользователи (1.1~)
Записи времени (1.1~)

Инструменты

Проблемы

Проблемы с поиском
- Фильтр по проекту, статусу, исполнителю и т. д.
- Поиск по ключевым словам
- Поддержка пользовательских полей
Создать/обновить проблемы
- Установить трекер, статус, приоритет
- Настроить пользовательские поля
- Добавить комментарии
Удалить проблемы

Проекты

Поиск проектов
- Фильтр по статусу «активно/архивировано/закрыто»
- Поиск по ключевым словам
Получить подробности проекта
- Включить трекеры, информацию о категориях
Создание/обновление проектов
- Настройка модулей и трекеров
- Установить наследование членов
Архивировать/разархивировать проекты
Удалить проекты

Время записи

Поиск записей времени
- Фильтр по проекту, пользователю, диапазону дат
Получить данные о времени входа
Создать/обновить записи времени
- Запись по проекту или проблеме
- Укажите вид деятельности
- Поддержка пользовательских полей
Удалить записи времени

Использование с Клодом

Чтобы использовать этот сервер с Клодом, настройте его следующим образом:

{
  "mcp-server-redmine": {
    "command": "npx",
    "args": [
      "-y",
      "--prefix",
      "/path/to/mcp-server-redmine",
      "mcp-server-redmine"
    ],
    "env": {
      "REDMINE_HOST": "https://your-redmine.example.com",
      "REDMINE_API_KEY": "your-api-key-here"
    }
  }
}

Параметры конфигурации

command : Команда для выполнения пакета npm
args :
- -y : Автоматически отвечать «да» на запросы
- --prefix : Указать каталог установки
- Последний аргумент указывает имя пакета.
env : Переменные среды
- REDMINE_HOST : URL-адрес сервера Redmine
- REDMINE_API_KEY : Ваш ключ API Redmine

Настраивать

Получение API-ключа

Включите REST API в настройках администратора Redmine
Получить ключ API со страницы настроек пользователя

Переменные среды

Установите следующие переменные среды:

REDMINE_API_KEY : API-ключ, полученный из настроек пользователя Redmine
REDMINE_HOST : URL-адрес сервера Redmine (например, https://redmine.example.com ).

Тестирование

Тесты модулей

# Run tests
npm test

В целях безопасности данных в тесты включены только операции GET.

Инспектор Тестирования

Используйте MCP Inspector для проверки функциональности:

# Build
npm run build

# Set execute permission (important)
chmod +x dist/index.js

# Launch inspector
npx @modelcontextprotocol/inspector dist/index.js

Разрешения

Для некоторых функций требуются права администратора:

Операции, связанные с пользователем

list_users : требуется администратор
create_user : требуется администратор
update_user : требуется администратор
delete_user : требуется администратор

Доступная информация зависит от уровня разрешений пользователя. Подробности см. в документации API Redmine .

Разработка

Требования

Node.js 18 или выше
нпм 9 или выше

Библиотеки

@modelcontextprotocol/sdk : MCP SDK
zod : Проверка схемы
typescript : система типов

Структура каталога

.
├── src/
│   ├── tools/            # Tool definitions
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── formatters/       # Formatters
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── lib/             # Common libraries
│   │   ├── client.ts     # Redmine API client
│   │   ├── config.ts     # Configuration management
│   │   └── types.ts      # Type definitions
│   ├── handlers.ts       # Request handlers
│   └── index.ts         # Entry point
├── docs/
│   └── adr/             # Architecture Decision Records
├── package.json         # Project configuration
├── tsconfig.json        # TypeScript configuration
└── README.md           # Documentation

Здание

# Install dependencies
npm install

# Build
npm run build

# Start development server
npm run dev

Записи архитектурных решений

Основные проектные решения задокументированы в docs/adr . Обращайтесь к этим документам при добавлении или изменении функций.

Лицензия

Массачусетский технологический институт

Связанные проекты

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Сервер Model Context Protocol для взаимодействия с Redmine с использованием REST API, позволяющий управлять тикетами, проектами и пользовательскими данными посредством интеграции с LLM.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MongoDB
kiliczsh
A
security
A
license
A
quality
A Model Context Protocol server that provides access to MongoDB databases. This server enables LLMs to inspect collection schemas and execute read-only queries.
Last updated -
8
817
217
TypeScript
MIT License
MCP Ethers Wallet
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
Last updated -
31
323
2
TypeScript
MIT License
MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License
MCP Server RubyGems
6
-
security
F
license
-
quality
A Model Context Protocol server that allows interaction with the RubyGems.org API to fetch metadata about Ruby packages, search gems, and explore dependencies and ownership information.
Last updated -
TypeScript

View all related MCP servers

Redmine MCP Server