Это проект ранней стадии. Не используйте его продуктивно - вклады приветствуются!

OpenProject MCP сервер

Сервер Model Context Protocol (MCP) обеспечивает бесшовную интеграцию с OpenProject API v3. Этот сервер позволяет приложениям LLM взаимодействовать с OpenProject для управления проектами, отслеживания рабочих пакетов и создания задач.

Особенности

Полная интеграция OpenProject API v3** ** Управление проектами**: Список и фильтр проектов ** Управление пакетом работ**: Создание, список и фильтр рабочих пакетов

• ️ ** Управление типом**: Список доступных типов рабочих пакетов Безопасная аутентификация: аутентификация на основе ключей API ** Поддержка прокси**: Опциональная конфигурация HTTP-прокси
• ** Операции по синтезу**: Построенный с использованием современных моделей Async/await
• Комплексная лесозаготовка: Конфигурируемые уровни лесозаготовок

Предпосылки

Python 3.10 или выше uv (быстрый менеджер пакетов Python)

• экземпляр OpenProject (облако или саморазмещение) OpenProject API (сгенерированный из профиля пользователя)

##Установка

###1.Установить uv (если он еще не установлен)

**macOS/Linux: **

Окна:

** Альтернатива (с использованием pip): **

###2 Клонирование и настройка проекта

###3.

⚠️ This is an early-stage project. Do not use it productively – contributions welcome!

OpenProject MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with OpenProject API v3. This server enables LLM applications to interact with OpenProject for project management, work package tracking, and task creation.

Features

• 🔌 Full OpenProject API v3 Integration
• 📋 Project Management: List and filter projects
• 📝 Work Package Management: Create, list, and filter work packages
• 🏷️ Type Management: List available work package types
• 🔐 Secure Authentication: API key-based authentication
• 🌐 Proxy Support: Optional HTTP proxy configuration
• 🚀 Async Operations: Built with modern async/await patterns
• 📊 Comprehensive Logging: Configurable logging levels

Prerequisites

• Python 3.10 or higher
• uv (fast Python package manager)
• An OpenProject instance (cloud or self-hosted)
• OpenProject API key (generated from your user profile)

Installation

1. Install uv (if not already installed)

macOS/Linux:

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

Windows:

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

Alternative (using pip):

pip install uv

2. Clone and Setup the Project

git clone https://github.com/yourusername/openproject-mcp.git
cd openproject-mcp

3. Create Virtual Environment and Install Dependencies

# Create virtual environment and install dependencies in one command
uv sync

Alternative (manual steps):

# Create virtual environment
uv venv

# Install dependencies
uv pip install -r requirements.txt

4. Configure Environment

# Copy the environment template
cp env_example.txt .env

Edit .env and add your OpenProject configuration:

OPENPROJECT_URL=https://your-instance.openproject.com
OPENPROJECT_API_KEY=your-api-key-here

Configuration

Environment Variables

Getting an API Key