Redmine MCP Server

MCP-сервер (Model Context Protocol), который подключает ИИ-ассистентов, таких как Kiro, к вашему экземпляру Redmine. Он предоставляет 15 инструментов, охватывающих задачи, проекты и поиск, — позволяя вашему ИИ-ассистенту создавать задачи, обновлять проекты, искать по ресурсам и многое другое с помощью естественного общения.

Что это делает

После настройки вы можете попросить вашего ИИ-ассистента, например:

• "Перечислить все открытые задачи, назначенные на меня"

• "Создать отчёт об ошибке для сбоя страницы входа"

• "Найти задачи, связанные с миграцией базы данных"

• "Архивировать проект old-website"

• "Добавить Джона как наблюдателя к задаче #42"

Сервер автоматически обрабатывает аутентификацию, пагинацию, проверку ввода и обработку ошибок.

Related MCP server: @a-bonus/redmine-mcp

Доступные инструменты

Предварительные требования

1. Python 3.10+ установлен на вашем компьютере

2. uv — быстрый менеджер пакетов Python (руководство по установке)

   • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

   • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. API-ключ Redmine — получите его в вашем экземпляре Redmine:

   • Войдите в Redmine

   • Перейдите в Моя учетная запись (меню в правом верхнем углу)

   • В правой боковой панели найдите ключ доступа API и нажмите Показать

   • Скопируйте ключ

Настройка с Kiro

Шаг 1: Добавьте конфигурацию MCP-сервера в Kiro

Создайте или отредактируйте ~/.kiro/settings/mcp.json (это сделает его доступным во всех ваших проектах):

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bizcloud-experts/redmine-mcp-server.git", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Замените:

• https://your-redmine-instance.com на URL вашего Redmine

• your-api-key-here на ваш API-ключ Redmine

Вы также можете разместить это в .kiro/settings/mcp.json в конкретном рабочем пространстве, если хотите, чтобы он был доступен только там.

Шаг 2: Откройте Kiro

MCP-сервер запустится автоматически при запуске Kiro. Вы можете проверить его работу, спросив: "Перечисли мои проекты Redmine."

Альтернатива: если git не установлен

Если вы получили ошибку "Git executable not found", вы можете использовать установку из zip-архива, которая не требует git на вашем компьютере:

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Альтернативная настройка: локальная установка

Если вы предпочитаете запускать из локального клона вместо uvx:

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install .

Затем используйте эту конфигурацию MCP вместо этого:

{
  "mcpServers": {
    "redmine": {
      "command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
      "args": [],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Устранение неполадок

Разработка

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest