MCP 项目编排器

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

特性

• 模板管理

  • 用于快速项目设置的项目模板
  • 用于模块化开发的组件模板
  • 变量替换和验证
  • 模板发现和版本控制

• 提示管理

  • 系统和用户提示模板
  • 变量替换
  • 提示分类和版本控制
  • 轻松的提示发现和重用

• Mermaid 图表生成

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

安装

pip install mcp-project-orchestrator

或者使用 Poetry：

poetry add mcp-project-orchestrator

快速开始

项目模板

from mcp_project_orchestrator.templates import TemplateManager

# 初始化模板管理器
manager = TemplateManager("path/to/templates")

# 列出可用模板
templates = manager.list_templates()
print(templates)

# 应用项目模板
manager.apply_template("fastapi-project", {
    "project_name": "my-api",
    "project_description": "My FastAPI project",
    "author_name": "John Doe",
    "author_email": "john@example.com"
})

提示管理

from mcp_project_orchestrator.prompts import PromptManager

# 初始化提示管理器
manager = PromptManager("path/to/prompts")

# 列出可用提示
prompts = manager.list_prompts()
print(prompts)

# 使用变量渲染提示
rendered = manager.render_prompt("system-prompt", {
    "name": "User",
    "project": "MCP"
})
print(rendered)

Mermaid 图表

from mcp_project_orchestrator.mermaid import MermaidGenerator, MermaidRenderer

# 初始化生成器
generator = MermaidGenerator()
renderer = MermaidRenderer()

# 生成流程图
flowchart = generator.generate_flowchart(
    nodes=[
        ("A", "Start"),
        ("B", "Process"),
        ("C", "End")
    ],
    edges=[
        ("A", "B", ""),
        ("B", "C", "")
    ]
)

# 渲染为 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

2. 安装依赖：

poetry install

3. 运行测试：

poetry run pytest

4. 运行代码检查：

poetry run ruff check .
poetry run mypy src/mcp_project_orchestrator

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request

许可证

该项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。

鸣谢

• 模型上下文协议 - 本项目的基础
• Mermaid - 用于图表生成
• Poetry - 用于依赖管理
• Ruff - 用于代码检查
• mypy - 用于类型检查