Workflow MCP Server

🚀 ワークフロー MCP サーバー

Python で開発された、構造化されたワークフローを誘導するエージェント用の MCP サーバーです。このサーバーは、エージェントが事前定義された手順に従って実行することを保証し、同時に実行の柔軟性を維持します。

🚀 クイックスタート

このワークフロー MCP サーバーは、Python で開発された構造化ワークフロー誘導エージェント用のサーバーです。以下に、開発方法、インストール、使用方法などの詳細を説明します。

✨ 主な機能

• エージェントが事前定義された手順に従って実行することを保証します。
• 実行の柔軟性を維持します。

📦 インストール

環境の設定

# 仮想環境の作成
uv venv

# 仮想環境のアクティブ化
source .venv/bin/activate  # Linux/macOS
# または
.venv\Scripts\activate     # Windows

# パッケージのインストール
uv pip install -e .

# 開発環境（テストツール付き）
uv pip install -e ".[dev]"

💻 使用例

サーバーの起動

# エントリースクリプトを使用する
uv run workflow-mcp

# または直接モジュールを使用する
uv run python -m workflow_mcp_server

SSE を使用して stdio ではなくする場合：

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

テストの実行

uv run pytest

📚 ドキュメント

開発方法

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 の説明に従ってインストールしてください。

ワークフロー定義

frameworks ディレクトリに、以下の構造の YAML ファイルを作成します。

name: "Simple Workflow"
description: "A linear workflow with basic steps"
version: "1.0"
steps:
  - id: "step1"
    type: "instruction"
    content: "这是你需要首先完成的事情"
    next: "step2"
    
  - id: "step2"
    type: "tool_call"
    tool: "工具名称"
    parameters:
      param1: "值1"
    next: "step3"
    
  - id: "step3"
    type: "end"
    content: "工作流完成"

利用可能なツール

• list_workflows(): 利用可能なワークフローフレームワークをリストします。
• start_workflow(workflow_id): 新しいワークフローセッションを開始します。
• complete_step(session_id, result): 現在のステップを完了としてマークし、次のステップを取得します。

📄 ライセンス

MIT