redmine-mcp-server

redmine-mcp-server — MCP-сервер сообщества (автор — jztan). Задачи, проекты и вики Redmine. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
jztan
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Создаёт и меняет задачи, учёт времени, вики и документы в Redmine, может отправлять письма Helpdesk; хранит вложения на диске. Есть режим только для чтения.

Настройка клиентов

codex
{
    "code": "[mcp_servers.redmine]\ncommand = \"npx\"\nargs = [\"-y\", \"mcp-client-http\", \"http://127.0.0.1:8000/mcp\"]",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Мост mcp-client-http",
    "verified": "docs"
}

Что умеет

Redmine MCP Server подключает ИИ-ассистентов к Redmine. Через инструменты MCP становятся доступны проекты, задачи, учёт времени, вики-страницы и файлы вашего экземпляра Redmine. Сервер построен на FastMCP.

Возможности:

  • 53 инструмента на стандартном Redmine и 69 с плагинами RedmineUP и DMSF. Задачи, проекты, новости, учёт времени, вики, диаграмма Ганта, файлы, участники, продукты и заказы, контакты и сделки CRM, документы DMSF, ответы Helpdesk по почте и другое. Ещё один служебный инструмент, cleanup_attachment_files, включается флагом REDMINE_MCP_EXPOSE_ADMIN_TOOLS=true.
  • Канбан-доска в чате. show_triage_board показывает живую доску задач с перетаскиванием через расширение MCP Apps.
  • Гибкая авторизация. Пять режимов через REDMINE_AUTH_MODE: legacy (по умолчанию, один общий ключ или логин), oauth и oauth-proxy (Redmine 6.1+), api-key-login (вход через браузер со своим ключом) и legacy-per-user (каждый пользователь передаёт свой ключ в заголовке X-Redmine-API-Key).
  • Защита от промпт-инъекций. Пользовательский контент оборачивается в граничные теги.
  • Режим только для чтения через REDMINE_MCP_READ_ONLY.
  • Раздача вложений по ссылкам с UUID, которые автоматически истекают.
  • Постраничный вывод с настраиваемыми лимитами.

Плагины Agile, Checklists, Products, CRM, DMSF и Helpdesk подключаются переменными окружения. Если флаг плагина не задан, его инструменты не регистрируются вовсе.

Интеграционные тесты полностью проходят на Redmine 6.1 и 7.0, более старые версии не проверялись. Отдельные инструменты требуют минимальной версии: глобальный поиск — 3.3.0+, наблюдатели — 2.3.0+.

Кому подойдёт

  • Командам на Redmine, которые хотят разбирать бэклог и вести задачи через ассистента.
  • Службам поддержки с плагинами RedmineUP Helpdesk и CRM.

Похожие серверы — в категории продуктивность.

Установка

Нужны Python 3.11+ (или Docker) и доступ к Redmine. Установите пакет командой pip install redmine-mcp-server, создайте файл .env с REDMINE_URL и REDMINE_API_KEY (или логином и паролем) и запустите redmine-mcp-server. Сервер слушает http://localhost:8000: MCP — по пути /mcp, проверка состояния — /health. Есть готовый образ ghcr.io/jztan/redmine-mcp-server для amd64 и arm64.

Подключение к клиентам

Конфиги приведены дословно из README для режимов legacy и oauth. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http redmine http://127.0.0.1:8000/mcp

Claude Desktop поддерживает только stdio, поэтому подключается через прокси FastMCP. Сервер Redmine MCP должен быть запущен заранее, а после правки claude_desktop_config.json приложение нужно полностью перезапустить. Cursor: ~/.cursor/mcp.json или .cursor/mcp.json в проекте. VS Code (1.102+): .vscode/mcp.json. Codex CLI: ~/.codex/config.toml, мост mcp-client-http. Есть и режим stdio (REDMINE_MCP_TRANSPORT=stdio, только в режиме legacy): клиент сам запускает uvx redmine-mcp-server, и HTTP-сервер не нужен.

Проверка

Выполните curl http://localhost:8000/health, затем попросите ассистента показать открытые задачи проекта.

Примеры задач

Покажи доску триажа по текущему спринту и предложи приоритеты.
Запиши 2 часа на задачу 1234 с комментарием «ревью кода».

Риски

  • Изменения в Redmine. Сервер создаёт и меняет задачи, записи времени, вики и документы, а с плагином Helpdesk отправляет письма клиентам. Для безопасного старта включите REDMINE_MCP_READ_ONLY.
  • Учётные данные. Ключ API или пароль храните в .env, а не в конфиге клиента.
  • Файлы. Вложения сохраняются в ATTACHMENTS_DIR, а в режиме stdio можно прикреплять локальные файлы из разрешённых папок.

Частые вопросы

Можно ли дать каждому пользователю свой доступ?

Да, через режимы oauth, oauth-proxy, api-key-login или legacy-per-user.

Нужны ли плагины?

Нет, сервер работает со стандартным Redmine; плагины добавляют инструменты.

Есть ли Docker?

Да: Dockerfile, docker-compose и образы на GHCR.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

1C MCP Toolkit

MCP и REST API сервер для баз 1С во внешней обработке: запросы, метаданные, журнал, справка BSL и выполнение кода.

Риск: high Лицензия: GPL-3.0 ★ 371

MCP BSL Platform Context

MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Источники