Workflow MCP 服务器

一个 Python MCP 服务器，用于引导代理完成结构化工作流程。该服务器确保代理遵循预定义的步骤，同时保持执行的灵活性。

开发方法

使用 UV 进行包管理

本项目专门使用 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
# OR
.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: "简单工作流程"
description: "具有基本步骤的线性工作流程"
version: "1.0"
steps:
  - id: "step1"
    type: "instruction"
    content: "这是您首先需要做的事情"
    next: "step2"
    
  - id: "step2"
    type: "tool_call"
    tool: "tool_name"
    parameters:
      param1: "value1"
    next: "step3"
    
  - id: "step3"
    type: "end"
    content: "工作流程完成"

可用工具

• list_workflows(): 列出可用的工作流程框架
• start_workflow(workflow_id): 启动一个新的工作流程会话
• complete_step(session_id, result): 将当前步骤标记为完成并获取下一步

许可证

MIT