Project Orchestrator

🚀 MCP Project Orchestrator

A comprehensive project orchestration tool for managing templates, prompts, and Mermaid diagrams in Model Context Protocol (MCP) projects.

✨ Features

• Template Management

  • Project templates for quick project setup
  • Component templates for modular development
  • Variable substitution and validation
  • Template discovery and version control

• Prompt Management

  • System and user prompt templates
  • Variable substitution
  • Prompt categorization and version control
  • Easy prompt discovery and reuse

• Mermaid Diagram Generation

  • Flowchart generation
  • Sequence diagram generation
  • Class diagram generation
  • SVG and PNG rendering
  • Diagram validation

📦 Installation

pip install mcp-project-orchestrator

Or use Poetry:

poetry add mcp-project-orchestrator

🚀 Quick Start

Project Templates

from mcp_project_orchestrator.templates import TemplateManager

# Initialize the 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": "john@example.com"
})

Prompt Management

from mcp_project_orchestrator.prompts import PromptManager

# Initialize the 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)

Mermaid Diagrams

from mcp_project_orchestrator.mermaid import MermaidGenerator, MermaidRenderer

# Initialize the generator and renderer
generator = MermaidGenerator()
renderer = MermaidRenderer()

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

# Render the flowchart as an SVG
renderer.render(flowchart, "flowchart.svg")

📚 Documentation

Project Structure

mcp-project-orchestrator/
├── src/
│   └── mcp_project_orchestrator/
│       ├── templates/
│       │   ├── __init__.py
│       │   ├── base.py
│       │   └── specific_template.py
│       ├── prompts/
│       │   ├── __init__.py
│       │   ├── system_prompt.py
│       │   └── user_prompt.py
│       └── mermaid/
│           ├── __init__.py
│           ├── flowchart.py
│           └── sequence_diagram.py
├── tests/
│   ├── test_templates.py
│   ├── test_prompts.py
│   └── test_mermaid.py
└── README.md

Contribution Guidelines

1. Create a feature branch
2. Commit your code changes
3. Push to the branch
4. Create a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👏 Acknowledgments

• Model Context Protocol - The foundation of this project
• Mermaid - For diagram generation
• Poetry - For dependency management
• Ruff - For code formatting checks