Workflow MCP Server

工作流 MCP 服务

一个 Python MCP 服务，用于引导 Agent 完成结构化工作流。此服务可确保 Agent 按照预定义步骤执行，同时保持执行上的灵活性。

开发方式

使用 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 中的说明操作。

安装

设置环境

# Create a virtual environment
uv venv

# Activate the virtual environment
source .venv/bin/activate  # Linux/macOS
# OR
.venv\Scripts\activate     # Windows

# Install the package
uv pip install -e .

# For development with testing tools
uv pip install -e ".[dev]"

用法

运行服务

# Using the entry point script
uv run workflow-mcp

# Or directly with module
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: "This is what you need to do first"
    next: "step2"
    
  - id: "step2"
    type: "tool_call"
    tool: "tool_name"
    parameters:
      param1: "value1"
    next: "step3"
    
  - id: "step3"
    type: "end"
    content: "Workflow complete"

可用工具

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

许可证

MIT