工作流 MCP 服务器

一个用 Python 开发的结构化工作流引导代理的 MCP 服务器。此服务器确保代理按照预定义步骤执行，同时保持执行的灵活性。

开发方法

使用 UV 进行包管理

该项目 exclusively 使用 uv 进行所有包管理操作。始终使用 uv 命令进行以下操作：

• 创建虚拟环境：uv venv
• 安装软件包：uv pip install
• 运行 Python 脚本：uv run python script.py
• 运行测试：uv run pytest
• 运行应用程序：uv run workflow-mcp

UV 提供比传统工具更快、更可靠的包管理。如果没有安装 uv，请按照 https://github.com/astral-sh/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

使用 SSE 而不是 stdio：

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

运行测试

uv run pytest

工作流定义

在 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