Project Orchestrator MCP server

The MCP Project Orchestrator is a comprehensive tool for managing Model Context Protocol (MCP) projects, providing template management, prompt organization, and Mermaid diagram generation capabilities. It streamlines the development workflow for MCP-based applications.

Installation

You can install the MCP Project Orchestrator using pip:

pip install mcp-project-orchestrator

If you need AWS integration support:

pip install mcp-project-orchestrator[aws]

Alternatively, you can use Poetry:

poetry add mcp-project-orchestrator
# Or with AWS support
poetry add mcp-project-orchestrator -E aws

Quick Start Guide

Using Project Templates

The template manager allows you to quickly set up new projects:

from mcp_project_orchestrator.templates import TemplateManager

# Initialize template manager
manager = TemplateManager("path/to/templates")

# List available templates
templates = manager.list_templates()
print(templates)

# Apply a project template
manager.apply_template("fastapi-project", {
    "project_name": "my-api",
    "project_description": "My FastAPI project",
    "author_name": "John Doe",
    "author_email": "[email protected]"
})

JSON-Driven Project Orchestration

You can customize your project setup through the configuration file:

chmod +x scripts/setup_orchestrator.sh
scripts/setup_orchestrator.sh

Edit config/project_orchestration.json to control which components to scaffold:

{
  "enable": {
    "cursorConfigs": true,
    "pythonMcp": true,
    "tsMcp": true,
    "cppMcp": true,
    "mcpClient": true,
    "backgroundAgent": true,
    "githubActions": true,
    "devcontainer": true,
    "awsTerraform": true,
    "webAndMcp": true,
    "cppConan": true,
    "esp32": true,
    "android": true
  }
}

Managing Prompts

The prompt manager helps organize and render prompt templates:

from mcp_project_orchestrator.prompts import PromptManager

# Initialize prompt manager
manager = PromptManager("path/to/prompts")

# List available prompts
prompts = manager.list_prompts()
print(prompts)

# Render a prompt with variables
rendered = manager.render_prompt("system-prompt", {
    "name": "User",
    "project": "MCP"
})
print(rendered)

Creating Mermaid Diagrams

Generate and render Mermaid diagrams programmatically:

from mcp_project_orchestrator.mermaid import MermaidGenerator, MermaidRenderer

# Initialize generators
generator = MermaidGenerator()
renderer = MermaidRenderer()

# Generate a flowchart
flowchart = generator.generate_flowchart(
    nodes=[
        ("A", "Start"),
        ("B", "Process"),
        ("C", "End")
    ],
    edges=[
        ("A", "B", ""),
        ("B", "C", "")
    ]
)

# Render to SVG
renderer.render(flowchart, "flowchart.svg")

OpenSSL Integration

The orchestrator includes OpenSSL project templates and Cursor AI configuration.

Create an OpenSSL Project

mcp-orchestrator create-openssl-project \
  --project-name my-secure-app \
  --deployment-target fips-government

Deploy AI Configuration

mcp-orchestrator deploy-cursor --project-type openssl

Available Templates

• openssl-consumer: Standard OpenSSL application
• openssl-fips: FIPS 140-3 government deployment

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "mcp-project-orchestrator" '{"command":"python","args":["-m","mcp_project_orchestrator"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "mcp-project-orchestrator": {
            "command": "python",
            "args": [
                "-m",
                "mcp_project_orchestrator"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "mcp-project-orchestrator": {
            "command": "python",
            "args": [
                "-m",
                "mcp_project_orchestrator"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect