工作流管理服务器

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

  • by tuanknguyen
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tuanknguyen/workflow-mcp-server

使用说明

工作流MCP服务器

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

开发方法

UV包装管理

本项目独家使用 紫外线 用于所有包管理操作。始终使用uv命令:

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

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

工作流定义

在中创建YAML文件 frameworks 目录具有以下结构:

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):将当前步骤标记为已完成并获取下一步

许可证

麻省理工学院