Сервер Redmine MCP

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

Функции

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

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

Инструменты

Проблемы

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

Проекты

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

Время записи

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

Related MCP server: MCP Ethers Wallet

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

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

{ "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 . Обращайтесь к этим документам при добавлении или изменении функций.

Лицензия

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

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

Deploy Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Redmine MCP Server