⚠️ 初期段階のプロジェクトです。 生産的に使用しないでください - 貢献を歓迎します!

OpenProject MCP サーバー

OpenProject API v3 とのシームレスな統合を実現するモデルコンテキストプロトコル(MCP)サーバー。 LLM アプリケーションは、プロジェクト管理、作業パッケージの追跡、タスク作成のために OpenProject とやり取りすることを可能にします。

##特徴

• フル OpenProject API v3 インテグレーション**
• プロジェクト管理**: リストとフィルタプロジェクト
• 作品パッケージ管理**: 作業パッケージの作成、リストの作成、およびフィルタリング
• ️️ タイプ管理: 利用可能な作業パッケージの種類をリスト
• 🔐Secure Authentication:APIキーベースの認証
• バックアッププロキシサポート:オプションのHTTPプロキシ設定
• OST 非同期操作: 現代の非同期/待ち合わせパターンで構築
• 関連する包括的なログ**: 設定可能なログレベル

前提条件

• Python 3.10以上
• uv(高速Pythonパッケージマネージャ)
• OpenProjectインスタンス(クラウドまたはセルフホスト)
• OpenProject API キー(ユーザープロファイルから生成)

インストール

##1. uvをインストール (インストールされていない場合)

macOS/Linux:

Windows:

代替(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