What is Mcp Project Orchestrator

mcp-project-orchestrator is a comprehensive project orchestration tool designed to manage Model Context Protocol (MCP) projects, templates, prompts, and Mermaid diagrams. It helps users analyze input to identify suitable design patterns and project templates, facilitating the creation of initial project files.

Use cases

Use cases include quickly setting up new projects using predefined templates, managing prompts for user interactions, and generating visual diagrams to represent project workflows and structures.

How to use

To use mcp-project-orchestrator, install it via pip or Poetry. Initialize the TemplateManager to manage project templates, list available templates, and apply a selected template by providing necessary parameters such as project name and description.

Key features

Key features include template management for quick project setup, prompt management for system and user prompts, and Mermaid diagram generation for flowcharts, sequence diagrams, and class diagrams with validation and rendering options.

Where to use

mcp-project-orchestrator can be used in software development, particularly in projects that require structured templates and diagrams, such as web applications, API development, and modular software design.

MCP Project Orchestrator

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

Features

• Template Management

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

• Prompt Management

  • System and user prompt templates
  • Variable substitution
  • Prompt categorization and versioning
  • 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 with Poetry:

poetry add mcp-project-orchestrator

Quick Start

Project Templates

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]"
})

Prompt Management

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)

Mermaid Diagrams

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")

Project Structure

mcp-project-orchestrator/
├── src/
│   └── mcp_project_orchestrator/
│       ├── templates/
│       │   ├── __init__.py
│       │   ├── base.py
│       │   ├── project.py
│       │   ├── component.py
│       │   └── manager.py
│       ├── prompts/
│       │   ├── __init__.py
│       │   ├── template.py
│       │   └── manager.py
│       └── mermaid/
│           ├── __init__.py
│           ├── generator.py
│           └── renderer.py
├── tests/
│   ├── __init__.py
│   ├── conftest.py
│   ├── test_templates.py
│   ├── test_prompts.py
│   └── test_mermaid.py
├── docs/
├── examples/
├── .github/
│   └── workflows/
│       └── ci.yml
├── pyproject.toml
├── Containerfile
└── README.md

Development

1. Clone the repository:

git clone https://github.com/yourusername/mcp-project-orchestrator.git
cd mcp-project-orchestrator

2. Install dependencies:

poetry install

3. Run tests:

poetry run pytest

4. Run linting:

poetry run ruff check .
poetry run mypy src/mcp_project_orchestrator

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. 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 for this project
• Mermaid - For diagram generation
• Poetry - For dependency management
• Ruff - For linting
• mypy - For type checking