home / mcp / mcp openproject server

MCP OpenProject Server

smithery平台依赖的open project mcp。

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "boma086-mcp-open-project": {
      "command": "python",
      "args": [
        "-m",
        "openproject.server"
      ],
      "env": {
        "OPENPROJECT_API_KEY": "YOUR_API_KEY",
        "OPENPROJECT_BASE_URL": "http://localhost:8090"
      }
    }
  }
}

You run an OpenProject MCP Server built on the FastMCP framework to give an AI assistant robust project management capabilities. It exposes OpenProject APIs through MCP, letting your AI workflows create, update, and query projects, tasks, and resources in a structured, programmable way.

How to use

Launch the OpenProject MCP Server locally or connect to it remotely from your MCP client. Start the server, then perform project planning, task tracking, and collaboration actions through the MCP interface. The server provides access to the full OpenProject API through MCP endpoints and handles configuration validation and error handling to keep your automation reliable.

How to install

Prerequisites: you need Python and a compatible environment to run the MCP server locally. You may also use the Smithery.ai deployment flow for hosting.

# Prerequisites
# Ensure Python 3.x is installed

# Local testing setup
export OPENPROJECT_BASE_URL=http://localhost:8090
export OPENPROJECT_API_KEY=your-api-key

# Install Python dependencies
pip install -r requirements.txt

# Run the MCP server
python -m openproject.server

If you prefer to deploy via Smithery.ai, push your code and deploy using the Smithery command-line tool.

# Push code to GitHub
git add .
git commit -m "Initial OpenProject MCP server"
git push origin main

# Deploy to Smithery.ai
npm install -g @smithery/cli
smithery deploy

Configuration and runtime notes

During local testing, configure the server to point at your OpenProject instance and provide an API key so the MCP server can authenticate requests.

Environment variables you may use for local testing:

- OPENPROJECT_BASE_URL: Base URL for the OpenProject instance (e.g., http://localhost:8090)

- OPENPROJECT_API_KEY: API key for authenticating with OpenProject

Available tools

openapi_to_mcp

Automatically converts OpenProject OpenAPI definitions to MCP-compatible endpoints and client stubs, enabling consistent MCP access to OpenProject APIs.

http_access

Provides HTTP-based remote access to the MCP server, allowing external clients to communicate with the OpenProject MCP endpoints over HTTP.

config_validation

Validates configuration and handles error reporting to ensure MCP client requests are well-formed and actionable.