Сервер 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: Redmine MCP Server

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

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

{
  "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-ключа

1. Включите REST API в настройках администратора Redmine

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

Лицензия

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

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

• Модель контекстного протокола

• MCP TypeScript SDK

• Редмайн