andyeverything/openproject-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

91 stars 62 forks 품질 65 트렌드 15

Repository Install

andyeverything/openproject-mcp-server는 MCP 서버 후보가 https://github.com/andyeverything/openproject-mcp-server.에서 수입되었습니다

개요

andyeverything/openproject-mcp-server는 MCP 서버 후보가 https://github.com/andyeverything/openproject-mcp-server.에서 수입되었습니다

개요(AI 번역)

⚠️ 초기 프로젝트입니다. 생산적으로 사용하지 마십시오 - 기여 환영!

OpenProject MCP 서버

OpenProject API v3와 원활한 통합을 제공하는 모델 Context Protocol (MCP) 서버. 이 서버는 LLM 애플리케이션을 사용하여 프로젝트 관리, 작업 패키지 추적 및 작업 생성을 위해 OpenProject와 상호 작용할 수 있습니다.

특징

دFull OpenProject API v3 통합
프로젝트 관리: 목록 및 필터 프로젝트
패키지 관리**: 생성, 목록 및 필터 작업 패키지
️ 타입 관리: 사용 가능한 작업 패키지 유형
̇Secure Authentication: API 키 기반 인증
프록시 지원**: HTTP 프록시 구성
♨ ** 동기화 작업**: 현대 async/await 본으로 건축하는
Comprehensive Logging: Configurable 로깅 레벨

필수품

Python 3.10 이상
uv (빠른 파이썬 패키지 관리자)
OpenProject 인스턴스 (클라우드 또는 자체 호스팅)
OpenProject API 키 (사용자 프로필에서 생성)

설치

##1. uv 설치 (여기 설치하지 않는 경우)

** macOS/리눅스:**

윈도우:

일부 (펌핑):

2. Clone 및 프로젝트 설정

# # # 3.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

⚠️ 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

Variable	Required	Description	Example
`OPENPROJECT_URL`	Yes	Your OpenProject instance URL	`https://mycompany.openproject.com`
`OPENPROJECT_API_KEY`	Yes	API key from your OpenProject user profile	`8169846b42461e6e...`
`OPENPROJECT_PROXY`	No	HTTP proxy URL if needed	`http://proxy.company.com:8080`
`LOG_LEVEL`	No	Logging level (DEBUG, INFO, WARNING, ERROR)	`INFO`
`TEST_CONNECTION_ON_STARTUP`	No	Test API connection when server starts	`true`

Getting an API Key

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "openproject-fastmcp": {
      "command": "D:\\Promete\\Project\\mcp-openproject\\openproject-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["D:\\Promete\\Project\\mcp-openproject\\openproject-mcp-server\\openproject-mcp-fastmcp.py"],
      "env": {
        "PYTHONPATH": "D:\\Promete\\Project\\mcp-openproject\\openproject-mcp-server",
        "OPENPROJECT_URL": "https://your-instance.com",
        "OPENPROJECT_API_KEY": "your-api-key"
      }
    }
  }
}