iflow-mcp_firsthalfhero-openproject-mcp-server

# OpenProject MCP Server A comprehensive FastMCP-powered server that enables AI assistants like Claude to interact with OpenProject installations. This implementation provides full project management functionality including user management, dynamic configuration, and advanced Gantt chart creation. ## 🎯 Core Features ### MVP Functionality - ✅ **Create projects** in OpenProject via AI assistant - ✅ **Create work packages** with start/due dates for Gantt charts - ✅ **Create dependencies** between work packages - ✅ **Generate proper Gantt charts** in OpenProject - ✅ **End-to-end workflow** from AI command to visual timeline ### Phase 1 Enhanced Features - ✅ **User management** - Find and assign users by email address - ✅ **Dynamic configuration** - Automatically load types, statuses, and priorities - ✅ **Email-based assignment** - Assign work packages without knowing user IDs - ✅ **Project member management** - View project members and their roles - ✅ **Enhanced error handling** - Detailed validation and error messages - ✅ **Performance optimization** - Intelligent caching and pagination ## 🚀 Quick Start ### Prerequisites 1. **OpenProject Instance**: You need a running OpenProject installation (local or cloud) 2. **API Key**: Generate an API key from your OpenProject profile 3. **Python 3.8+**: Required for running the MCP server ### Installation 1. **Clone or download** the project: ```bash cd openproject-mcp-server ``` 2. **Create and activate virtual environment**: ```bash python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate ``` 3. **Install dependencies**: ```bash pip install -r requirements.txt ``` 4. **Configure environment**: ```bash cp env.example .env # Edit .env with your OpenProject details ``` ### Configuration Edit the `.env` file with your OpenProject details: ```env # OpenProject Instance URL (include protocol) OPENPROJECT_URL=http://localhost:3000 # OpenProject API…