一个模型上下文协议(MCP)服务器,使AI助手能够与OpenProject安装交互. 创建项目,管理工作包,指派团队成员,并通过自然语言命令生成甘特图.

□ 特性

• ** 项目管理**: 创建和管理 OpenProject 项目
• ** 一揽子工作方案业务**: 创建、更新和指定带有日期的工作包
• ** 扶养管理**: 为甘特图表创建工作包之间的关系
• 用户管理: 通过电子邮件地址查找和指派用户
• 团队协作**: 管理项目成员及其作用
• ** 动态配置**: 自动加载工作包类型、状态和优先事项
• ** 综合报告**:项目状况报告和小组工作量分析

□ 安装

· 先决条件

• OpenProject实例(本地或云)
• 来自您的 OpenProject 配置文件的 API 密钥
• Python 3.8+或多克语

· 方法1: Docker(建议)

1. ** 登记存放处**:

2. ** 配置环境**:

3. ** 与Docker一起部署**:

方法2:活字

1. ** 类别和设置**:

2. ** 配置环境**:

3. ** 试验配置**:

□ 配置

创建一个`.

OpenProject MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with OpenProject installations. Create projects, manage work packages, assign team members, and generate Gantt charts through natural language commands.

Features

• Project Management: Create and manage OpenProject projects
• Work Package Operations: Create, update, and assign work packages with dates
• Dependency Management: Create relationships between work packages for Gantt charts
• User Management: Find and assign users by email address
• Team Collaboration: Manage project members and their roles
• Dynamic Configuration: Automatically loads work package types, statuses, and priorities
• Comprehensive Reporting: Project status reports and team workload analysis

Installation

Prerequisites

• OpenProject instance (local or cloud)
• API key from your OpenProject profile
• Python 3.8+ or Docker

Method 1: Docker (Recommended)

1. Clone the repository:

   git clone 
   cd openproject-mcp-server
   

2. Configure environment:

   cp env.example .env
   # Edit .env with your OpenProject details
   

3. Deploy with Docker:

   ./scripts/deploy.sh deploy 39127
   

Method 2: Python

1. Clone and setup:

   git clone 
   cd openproject-mcp-server
   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   

2. Configure environment:

   cp env.example .env
   # Edit .env with your OpenProject details
   

3. Test configuration:

   python3 scripts/test_mvp.py
   

Configuration

Create a .env file with your OpenProject details:

# OpenProject Instance URL (include protocol)
OPENPROJECT_URL=http://localhost:8080

# OpenProject API Key (from your user profile)
OPENPROJECT_API_KEY=your_40_character_api_key_here

# MCP Server Configuration (optional)
MCP_HOST=localhost
MCP_PORT=39127
MCP_LOG_LEVEL=INFO

Getting your OpenProject API Key

1. Login to your OpenProject instance
2. Go to My Account → Access Tokens
3. Click + New token
4. Enter a name (e.g., “MCP Server”)
5. Copy the generated 40-character token

Usage

Starting the Server

Docker:

./scripts/deploy.sh deploy 39127

Python:

python3 scripts/run_server.py

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

For Docker deployment:

{
  "mcpServers": {
    "openproject": {
      "transport": "sse",
      "url": "http://localhost:39127/sse"
    }
  }
}

For local Python:

{
  "mcpServers": {
    "openproject": {
      "command": "python3",
      "args": ["/full/path/to/openproject-mcp-server/scripts/run_server.py"],
      "env": {
        "OPENPROJECT_URL": "http://localhost:8080",