Project Orchestrator

🚀 MCP 項目 orchestrator

MCP 項目 orchestrator 是一個全面的項目編排工具，可用於管理 Model Context Protocol (MCP) 項目的模板、提示和 Mermaid 圖形，極大提升項目管理效率。

🚀 快速開始

項目模板

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

✨ 主要特性

• 模板管理
  • 提供項目模板，可快速設置項目。
  • 具備組件模板，支持模塊化開發。
  • 支持變量替換和驗證。
  • 可進行模板發現和版本控制。
• 提示管理
  • 包含系統提示和用戶提示模板。
  • 支持變量替換。
  • 可對提示進行分類和版本控制。
  • 便於發現和重用提示。
• 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
│       │   └── specific_template.py
│       ├── prompts/
│       │   ├── __init__.py
│       │   ├── system_prompt.py
│       │   └── user_prompt.py
│       └── mermaid/
│           ├── __init__.py
│           ├── flowchart.py
│           └── sequence_diagram.py
├── tests/
│   ├── test_templates.py
│   ├── test_prompts.py
│   └── test_mermaid.py
└── README.md

貢獻指南

1. 創建功能分支
2. 提交代碼更改
3. 推動到分支
4. 創建 Pull Request

📄 許可證

此項目在 MIT License 下許可 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

• Model Context Protocol - 此項目的基石
• Mermaid - 用於圖形生成
• Poetry - 用於依賴管理
• Ruff - 用於代碼格式檢查