mcpField
W
Workflow MCP Server

Workflow MCP Server

Local
github.com/tuanknguyenAI & Agents1Updated 81w ago
Repository

About Workflow MCP Server

Workflow MCP Server is a Python MCP server that guides agents through predefined, step-based workflows while allowing flexibility in execution. Workflows are defined in YAML, and sessions advance as steps are completed.

Key features

  1. 01List available workflows
  2. 02Start workflow sessions
  3. 03Complete steps and retrieve the next step
  4. 04Define workflows in YAML
  5. 05Run with stdio or SSE

Use cases

  1. 01Guide an agent through an ordered procedure
  2. 02Use YAML-defined workflows for repeatable tasks

MCP support

Exposes workflow listing, session start, and step completion tools to MCP clients. It supports stdio and SSE transports.

#workflow#mcp#server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Workflow MCP Server

A Python MCP server that guides agents through structured workflows. This server ensures agents follow predefined steps while maintaining flexibility in execution.

Development Approach

Package Management with UV

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

  • Virtual environment creation: uv venv
  • Package installation: uv pip install
  • Running Python scripts: uv run python script.py
  • Running tests: uv run pytest
  • Running the application: uv run workflow-mcp

UV provides faster, more reliable package management than traditional tools. If you don't have uv installed, follow instructions at https://github.com/astral-sh/uv

Installation

Setting 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 the package
uv pip install -e .

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

Usage

Running the server
# Using the entry point script
uv run workflow-mcp

# Or directly with module
uv run python -m workflow_mcp_server

With SSE instead of stdio:

uv run workflow-mcp --sse --port 8888
Running tests
uv run pytest
Workflow Definition

Create YAML files 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: "value1"
    next: "step3"
    
  - id: "step3"
    type: "end"
    content: "Workflow complete"

Available Tools

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

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.