OpenProject MCP Server

MCP (Model Context Protocol) сервер для интеграции OpenProject с AI IDE, такими как Cursor.

Возможности

• get_ai_tasks — получение списка задач, готовых к разработке AI

  • Возвращает задачи из колонок "Баги" и "Готово к разработке"
  • Фильтрует только задачи с флагом ai_dev = true
  • Возвращает: id, url, subject, description, type, status, priority, assignee

• get_task — получение детальной информации о задаче по ID

Установка

1. Клонирование и установка зависимостей

cd /root/repos/openproject_mcp
pip install -e .

2. Настройка

Создайте файл .env на основе .env.example:

cp .env.example .env

Отредактируйте .env:

OPENPROJECT_URL=openproject_api_url
OPENPROJECT_API_KEY=your_api_key_here

3. Настройка Cursor

Добавьте в конфигурацию MCP серверов Cursor (~/.cursor/mcp.json).

Важно: После pip install -e . команда openproject-mcp становится доступна в PATH.

Вариант A: После установки через pip (рекомендуется)

{
  "mcpServers": {
    "openproject": {
      "command": "openproject-mcp",
      "env": {
        "OPENPROJECT_URL": "openproject_api_url",
        "OPENPROJECT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Вариант B: Без установки (указать путь к Python)

{
  "mcpServers": {
    "openproject": {
      "command": "python",
      "args": ["-m", "openproject_mcp.server"],
      "cwd": "/path/to/openproject_mcp/src",
      "env": {
        "OPENPROJECT_URL": "openproject_api_url",
        "OPENPROJECT_API_KEY": "your_api_key_here"
      }
    }
  }
}

Вариант C: Через uv/uvx

{
  "mcpServers": {
    "openproject": {
      "command": "uvx",
      "args": ["--from", "/path/to/openproject_mcp", "openproject-mcp"],
      "env": {
        "OPENPROJECT_URL": "openproject_api_url",
        "OPENPROJECT_API_KEY": "your_api_key_here"
      }
    }
  }
}

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

После настройки в Cursor будут доступны инструменты:

Получить задачи для AI

Используй инструмент get_ai_tasks чтобы получить список задач готовых к разработке

Получить конкретную задачу

Используй инструмент get_task с task_id=2243 чтобы получить детали задачи

Конфигурация

Переменная	Описание	По умолчанию
OPENPROJECT_URL	URL OpenProject	openproject_api_url
OPENPROJECT_API_KEY	API ключ	-
OPENPROJECT_QUERY_ID_BUGS	ID query колонки "Баги"	1390
OPENPROJECT_QUERY_ID_READY	ID query колонки "Готово к разработке"	1378
OPENPROJECT_AI_DEV_FIELD	Имя кастомного поля ai_dev	customField2

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

1. Войдите в OpenProject
2. Перейдите в My Account → Access tokens
3. Создайте новый API токен
4. Скопируйте токен в конфигурацию

Разработка

# Установка в режиме разработки
pip install -e ".[dev]"

# Запуск сервера напрямую
python -m openproject_mcp.server

Лицензия

MIT