Workflow MCP Server

🚀 工作流 MCP 服務器

這是一個採用 Python 開發的 MCP 服務器，作為結構化工作流引導代理。它能確保代理依照預定義步驟執行任務，同時還具備執行的靈活性。

🚀 快速開始

本服務器使用 Python 開發，藉助 uv 工具進行包管理，下面將介紹具體的安裝和使用方法。

✨ 主要特性

• 確保代理按預定義步驟執行任務。
• 執行過程具備靈活性。
• 使用 uv 進行包管理，速度快且可靠。

📦 安裝指南

設置環境

# 創建虛擬環境
uv venv

# 激活虛擬環境
source .venv/bin/activate  # Linux/macOS
# 或者
.venv\Scripts\activate     # Windows

# 安裝包
uv pip install -e .

# 開發環境（帶測試工具）
uv pip install -e ".[dev]"

💻 使用示例

基礎用法

運行服務器

# 使用入口腳本
uv run workflow-mcp

# 或者直接使用模塊
uv run python -m workflow_mcp_server

運行測試

uv run pytest

高級用法

使用 SSE 而不是 stdio：

uv run workflow-mcp --sse --port 8888

📚 詳細文檔

工作流定義

在 frameworks 目錄中創建 YAML 文件，結構如下：

name: "Simple Workflow"
description: "A linear workflow with basic steps"
version: "1.0"
steps:
  - id: "step1"
    type: "instruction"
    content: "這是你需要首先完成的事情"
    next: "step2"
    
  - id: "step2"
    type: "tool_call"
    tool: "工具名稱"
    parameters:
      param1: "值1"
    next: "step3"
    
  - id: "step3"
    type: "end"
    content: "工作流完成"

可用工具

• list_workflows(): 列出可用的工作流框架
• start_workflow(workflow_id): 啟動新的工作流會話
• complete_step(session_id, result): 標記當前步驟為完成並獲取下一個步驟

📄 許可證

本項目採用 MIT 許可證。