MCP Редмайн

Статус: Работает отлично и используется ежедневно, никаких известных ошибок не обнаружено.

Status2: Я только что добавил пакет в PyPI и обновил инструкции по использованию. Пожалуйста, сообщайте о любых проблемах :)

Пусть Клод станет вашим помощником Redmine! MCP Redmine подключает Claude Desktop к вашему экземпляру Redmine, позволяя ему:

Поиск и просмотр проектов и проблем
Создавайте и обновляйте выпуски с полной поддержкой разметки
Загрузка и скачивание вложенных файлов
Управляйте и отслеживайте записи времени
Обновите статусы и поля проблем
Получите доступ к комплексным функциям API Redmine

Использует httpx для запросов API и интегрируется со спецификацией Redmine OpenAPI для всестороннего охвата API.

MCP Redmine в действии

Установка

Убедитесь, что у вас установлено УФ-излучение:

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

Related MCP server: MCP Alchemy

Использование с Claude Desktop

Добавьте в ваш claude_desktop_config.json :

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "mcp-redmine==2025.04.09.153531", 
               "--refresh-package", "mcp-redmine", "mcp-redmine"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.example.com",
        "REDMINE_API_KEY": "your-api-key",
        "REDMINE_REQUEST_INSTRUCTIONS": "/path/to/instructions.md"
      }
    }
  }
}

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

REDMINE_URL : URL вашего экземпляра Redmine (обязательно)
REDMINE_API_KEY : Ваш ключ API Redmine (обязательно, как его получить, смотрите ниже)
REDMINE_REQUEST_INSTRUCTIONS : Путь к файлу, содержащему дополнительные инструкции для инструмента redmine_request (необязательно). Я обнаружил, что это отлично работает, когда LLM генерирует этот файл после сеанса. ( example1 example2 )

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

Войдите в свой экземпляр Redmine.
Перейдите в раздел «Моя учетная запись» (обычно находится в правом верхнем меню)
В правой части страницы вы должны увидеть «Ключ доступа API».
Нажмите «Показать», чтобы просмотреть существующий ключ, или «Сгенерировать», чтобы создать новый.
Скопируйте этот ключ для использования в вашей конфигурации.

API

Инструменты

redmine_paths_list
- Возвращает список доступных путей API из спецификации OpenAPI
- Ввод не требуется
- Возвращает строку YAML, содержащую список шаблонов путей: GXP3
redmine_paths_info
- Получить полную информацию о пути для заданных шаблонов пути
- Ввод: path_templates (список строк)
- Возвращает строку YAML, содержащую спецификации API для запрошенных путей: GXP4
redmine_request
- Сделайте запрос к API Redmine
- Входные данные:
  - path (строка): путь к конечной точке API (например, '/issues.json')
  - method (строка, необязательно): HTTP-метод для использования (по умолчанию: «get»)
  - data (объект, необязательно): Словарь для тела запроса (для POST/PUT)
  - params (объект, необязательно): Словарь для параметров запроса
- Возвращает строку YAML, содержащую код статуса ответа, тело и сообщение об ошибке: GXP5
redmine_upload
- Загрузите файл в Redmine и получите токен для прикрепления
- Входные данные:
  - file_path (строка): Полный путь к файлу для загрузки.
  - description (строка, необязательно): Необязательное описание файла.
- Возвращает строку YAML в том же формате, что и redmine_request, включая токен загрузки: GXP6
redmine_download
- Загрузите вложение из Redmine и сохраните его в локальном файле.
- Входные данные:
  - attachment_id (целое число): идентификатор вложения для загрузки.
  - save_path (строка): Полный путь, по которому следует сохранить файл.
  - filename (строка, необязательно): Необязательное имя файла для использования (определяется автоматически, если не указано)
- Возвращает строку YAML с результатами загрузки: GXP7

Примеры

Создание нового выпуска

Let's create a new bug report in the "Website" project:

1. Title: "Homepage not loading on mobile devices"
2. Description: "When accessing the homepage from iOS or Android devices, the loading spinner appears but the content never loads. This issue started after the last deployment."
3. Priority: High
4. Assign to: John Smith

Поиск проблем

Can you find all high priority issues in the "Website" project that are currently unassigned?

Обновление статуса проблемы

Please mark issue #123 as "In Progress" and add a comment: "I've started working on this issue. Expect it to be completed by Friday."

Время регистрации

Log 3.5 hours against issue #456 for "Implementing user authentication" done today.

Списки каталогов MCP

MCP Redmine указан в следующих каталогах MCP и репозиториях:

Развивающийся

Сначала клонируйте репозиторий github и установите зависимости:

git clone git@github.com:runekaagaard/mcp-redmine.git
cd mcp-redmine
uv sync

Затем установите это в claude_desktop_config.json:

...
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-redmine", "-m", "mcp_redmine.server", "main"],
...

Мои другие проекты LLM

MCP Alchemy — подключение Claude Desktop к базам данных для изучения схемы и выполнения SQL.
MCP Notmuch Sendmail — помощник по работе с электронной почтой для Claude Desktop с использованием notmuch.
Diffpilot — многоколоночный просмотрщик различий Git с группировкой файлов и тегами.
Локальные файлы Claude — доступ к локальным файлам в артефактах Claude Desktop.

Внося вклад

Вклады горячо приветствуются! Будь то отчеты об ошибках, запросы функций, улучшения документации или вклад в код — любой вклад ценен. Не стесняйтесь:

Откройте тему, чтобы сообщить об ошибках или предложить новые функции
Отправляйте запросы на внесение изменений с улучшениями
Расширьте документацию или поделитесь своими примерами использования
Задавайте вопросы и делитесь своим опытом

Цель — сделать управление проектами Redmine с Клодом еще лучше, и ваши идеи и вклад помогут достичь этой цели.

Благодарности

Этот проект основан на превосходной работе других:

httpx — для обработки HTTP-запросов
Спецификация Redmine OpenAPI — для полной спецификации API
Redmine — гибкое веб-приложение для управления проектами

Лицензия

Публичная лицензия Mozilla версии 2.0

MCP Redmine