Supports containerized deployment using Docker, with specific container configurations for testing and development workflows.
Integrates with GitHub Actions for CI/CD pipelines, including automated testing, container image building, and deployment workflows.
Generates visual diagrams using the Mermaid tool to help visualize project architecture and implementation strategies in the generated documentation.
Supports containerized deployment using Podman as an alternative to Docker, with specialized scripts for mounting project directories and resolving module loading issues.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Project Orchestratorcreate a new FastAPI project with authentication and database support"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
AWS MCP Integration
AWS service access (S3, EC2, Lambda, CloudFormation, IAM)
AWS best practices enforcement
Cost optimization recommendations
Security and compliance guidance
See AWS_MCP.md for details
Related MCP server: MCP Maker
Installation
pip install mcp-project-orchestratorFor AWS integration support:
pip install mcp-project-orchestrator[aws]Or with Poetry:
poetry add mcp-project-orchestrator
# Or with AWS support
poetry add mcp-project-orchestrator -E awsUsing as a Conan dependency (for ai-servis)
This repository provides a Conan v2 package exposing the Python environment and CLI. In ai-servis's conanfile.py add:
def requirements(self):
self.requires("mcp-project-orchestrator/0.1.0@sparesparrow/stable")Then activate the run environment so mcp-orchestrator is on PATH and the package is on PYTHONPATH:
conan profile detect --force
conan create . --user=sparesparrow --channel=stable
conan install mcp-project-orchestrator/0.1.0@sparesparrow/stable -g VirtualRunEnv
./conanrun.sh mcp-orchestrator --helpQuick 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"
})JSON-Driven Project Orchestration
The setup script reads config/project_orchestration.json to enable/disable features and set ports and tool options.
Run the setup:
chmod +x scripts/setup_orchestrator.sh
scripts/setup_orchestrator.shEdit config/project_orchestration.json to control scaffolding:
{
"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
}
}Set items to
falseto skip generating those components.Ports and URLs are respected across
.cursor/webhooks,.cursor/agents,DockerfileEXPOSE, andcompose.yaml.
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.mdDevelopment
Clone the repository:
git clone https://github.com/yourusername/mcp-project-orchestrator.git
cd mcp-project-orchestratorInstall dependencies:
poetry installRun tests:
poetry run pytestRun linting:
poetry run ruff check .
poetry run mypy src/mcp_project_orchestratorContributing
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
OpenSSL Integration
Enhanced with OpenSSL project templates and Cursor AI configuration.
Create OpenSSL Project
mcp-orchestrator create-openssl-project \
--project-name my-secure-app \
--deployment-target fips-governmentDeploy AI Configuration
mcp-orchestrator deploy-cursor --project-type opensslTemplates Available
openssl-consumer: Standard OpenSSL applicationopenssl-fips: FIPS 140-3 government deployment