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

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

Разработка

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

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

Лицензия

MIT

OpenProject MCP Server

OpenProject MCP Server

Возможности

Установка

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

2. Настройка

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

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

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

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

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

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

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

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

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

Разработка

Лицензия

Latest Blog Posts

MCP directory API