Workflow MCP Server

🚀 Workflow MCP Server

A MCP server for a structured workflow-guided agent developed in Python. This server ensures that the agent executes according to predefined steps while maintaining flexibility in execution.

🚀 Quick Start

Package Management with UV

This project exclusively uses uv for all package management operations. Always use the following uv commands:

• Create a virtual environment: uv venv
• Install packages: uv pip install
• Run Python scripts: uv run python script.py
• Run tests: uv run pytest
• Run the application: uv run workflow-mcp

UV provides faster and more reliable package management than traditional tools. If uv is not installed, follow the instructions at https://github.com/astral-sh/uv to install it.

📦 Installation

Set up the environment

# Create a virtual environment
uv venv

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

# Install packages
uv pip install -e .

# Development environment (with testing tools)
uv pip install -e ".[dev]"

💻 Usage Examples

Run the server

# Use the entry script
uv run workflow-mcp

# Or use the module directly
uv run python -m workflow_mcp_server

Use SSE instead of stdio:

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

Run tests

uv run pytest

Workflow Definition

Create a YAML file in the frameworks directory with the following structure:

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: "Value 1"
    next: "step3"
    
  - id: "step3"
    type: "end"
    content: "Workflow completed"

Available Tools

• list_workflows(): List available workflow frameworks
• start_workflow(workflow_id): Start a new workflow session
• complete_step(session_id, result): Mark the current step as completed and get the next step

📄 License

MIT