Workflow MCP Server

ワークフロー 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 の手順に従ってください。

インストール

環境のセットアップ

# 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

stdio の代わりに SSE を使用する場合：

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