MCP Project Orchestrator

MCP项目协调员

  ](https://badge.fury.io/py/mcp-project-orchestrator)  

一个全面的项目协调工具，用于管理模型上下文协议（MCP）项目、模板、提示和Mermaid图表。

特点/特性

• 模板管理

- 用于快速项目设置的项目模板 - 模块化开发的组件模板 - 变量替换和验证 - 模板发现与版本管理

• 提示管理

- 系统和用户提示模板 - 变量替换 - 快速分类和版本管理 - 轻松发现和重用提示

• 美人鱼图生成

- 流程图生成 - 序列图生成 - 类图生成 - SVG和PNG渲染 - 图表验证

• AWS MCP 集成

- AWS 服务访问（S3、EC2、Lambda、CloudFormation、IAM） - AWS最佳实践的执行 - 成本优化建议 - 安全与合规指南 - 看 AWS_MCP.md 翻译为中文是：“AWS_MCP.md 文件” 或 “AWS_MCP 的 Markdown 文件”。这里，“AWS”代表亚马逊网络服务（Amazon Web Services），“MCP”可能是某个特定项目、配置或概念的缩写，具体含义需根据上下文确定。而“.md”是 Markdown 文件的扩展名，表示这是一个使用 Markdown 格式编写的文件 详情如下

安装

pip install mcp-project-orchestrator

对于AWS集成支持：

pip install mcp-project-orchestrator[aws]

或者与诗歌一起：

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

作为Conan依赖项使用（用于ai-servis）

这个仓库提供了一个Conan v2包，用于暴露Python环境和命令行界面（CLI）。在 ai-serviss conanfile.py 添加：

def requirements(self):
    self.requires("mcp-project-orchestrator/0.1.0@sparesparrow/stable")

然后激活运行环境以便 mcp-orchestrator 开着/处于开启状态 PATH 并且包裹已经（被）寄出了 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 --help

快速入门

项目模板

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驱动的项目编排

安装脚本读取 config/project_orchestration.json 启用/禁用功能，并设置端口和工具选项。

运行安装程序：

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

编辑 config/project_orchestration.json 控制脚手架：

{
  "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
  }
}

• 设置项目为 false 跳过生成这些组件。
• 端口和URL在跨（网络/系统）中是被识别的 .cursor/webhooks， .cursor/agents， Dockerfile 曝光，并且 compose.yaml.

提示管理

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)

美人鱼图（或称为“泳道图”）

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

项目结构

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

发展

1. 克隆仓库：

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

1. 安装依赖项：

poetry install

1. 运行测试：

poetry run pytest

1. 运行代码检查：

poetry run ruff check .
poetry run mypy src/mcp_project_orchestrator

做出贡献

1. 为仓库创建分支（或“克隆仓库”）
2. 创建一个特性分支
3. 提交您的更改
4. 推送到分支
5. 创建一个拉取请求

许可证

这个项目采用MIT许可证授权——详见 许可证 详情请见文件。

致谢

• 模型上下文协议 - 该项目的基础
• 美人鱼 - 用于生成图表
• 诗歌 - 用于依赖管理
• “Ruff”翻译成中文可以是“粗略”或“大致”，具体含义需根据上下文来确定。在描述某事物时，若用“Ruff”表示一种大致的、不精确的描述，那么翻译为“粗略”或“大致”是合适的 - 用于代码检查（或语法检查）
• mypy - 用于类型检查

OpenSSL 集成

增强了OpenSSL项目模板和Cursor AI配置。

创建OpenSSL项目

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

部署AI配置

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

可用模板

• openssl-consumer标准OpenSSL应用程序
• openssl-fipsFIPS 140-3 政府部署