mcp-project-orchestrator MCP Server

Use This MCP server To

Automate MCP project initialization with predefined templates Generate project files based on user input and design patterns Manage reusable component templates for modular development Create and update Mermaid diagrams for project visualization Standardize project scaffolding across teams using templates

README

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

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

Clone the repository:

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

Install dependencies:

poetry install

Run tests:

poetry run pytest

Run linting:

poetry run ruff check .
poetry run mypy src/mcp_project_orchestrator

Contributing

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
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

mcp-project-orchestrator FAQ

How does the MCP Project Orchestrator identify suitable design patterns?

It analyzes user input and matches it with predefined design patterns and project templates to recommend the best fit.

Can I customize the project templates used by the orchestrator?

Yes, you can create and manage your own project and component templates to tailor project setups.

Does the orchestrator support integration with Mermaid diagrams?

Yes, it supports creating and managing Mermaid diagrams for visualizing project architecture.

Is the MCP Project Orchestrator compatible with multiple MCP hosts?

Yes, it is designed to work across various MCP hosts by providing standardized project orchestration.

What programming languages does the orchestrator support?

While primarily Python-based, it can manage templates for any language as defined in the project templates.

How does the orchestrator handle variable substitution in templates?

It supports variable substitution to customize templates dynamically during project creation.

Is there CI/CD support for the MCP Project Orchestrator?

Yes, the project includes CI/CD workflows to ensure quality and continuous integration.

Under what license is the MCP Project Orchestrator released?

It is released under the MIT License, allowing flexible use and modification.