mcp-flowise

mcp-flowise 、Flowise API と統合された Model Context Protocol (MCP) サーバーを実装した Python パッケージです。チャットフローの一覧表示、予測の作成、Flowise チャットフローやアシスタント用のツールの動的な登録を、標準化された柔軟な方法で実行できます。

次の 2 つの動作モードをサポートしています。

• 低レベル モード (デフォルト) : Flowwise API から取得したすべてのチャットフローのツールを動的に登録します。

• FastMCP モード: チャットフローをリストし、予測を作成するための静的ツールを提供します。よりシンプルな構成に適しています。

特徴

• 動的ツール公開: LowLevel モードでは、各チャットフローまたはアシスタントのツールが動的に作成されます。

• よりシンプルな構成: FastMCP モードでは、最小限のセットアップでlist_chatflowsおよびcreate_predictionツールが公開されます。

• 柔軟なフィルタリング: どちらのモードも、ID または名前 (正規表現) によるホワイトリストとブラックリストによるチャットフローのフィルタリングをサポートしています。

• MCP 統合: MCP ワークフローにシームレスに統合します。

Related MCP server: MCP Python Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の mcp-flowise を自動的にインストールするには:

npx -y @smithery/cli install @andydukes/mcp-flowise --client claude

前提条件

• Python 3.12以上

• uvxパッケージマネージャー

uvx経由でインストールして実行

uvxを使用して GitHub リポジトリから直接サーバーを実行できることを確認します。

uvx --from git+https://github.com/andydukes/mcp-flowise mcp-flowise

MCP エコシステムへの追加 ( mcpServers構成)

mcpServers設定にmcp-flowise追加することで、MCP エコシステムに統合できます。例:

{
    "mcpServers": {
        "mcp-flowise": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/andydukes/mcp-flowise",
                "mcp-flowise"
            ],
            "env": {
                "FLOWISE_API_KEY": "${FLOWISE_API_KEY}",
                "FLOWISE_API_ENDPOINT": "${FLOWISE_API_ENDPOINT}"
            }
        }
    }
}

動作モード

1. FastMCPモード（シンプルモード）

FLOWISE_SIMPLE_MODE=trueを設定すると有効になります。このモードは次のようになります。

• 2 つのツール、 list_chatflowsとcreate_predictionを公開します。

• FLOWISE_CHATFLOW_IDまたはFLOWISE_ASSISTANT_IDを使用して静的構成を許可します。

• list_chatflowsを介して利用可能なすべてのチャットフローを一覧表示します。

2. 低レベルモード（FLOWISE_SIMPLE_MODE=False）

特徴：

• すべてのチャットフローを個別のツールとして動的に登録します。

• ツールはチャットフロー名（正規化）に基づいて命名されます。

• FLOWISE_CHATFLOW_DESCRIPTIONS変数の説明を使用し、説明が指定されていない場合はチャットフロー名にフォールバックします。

例：

• my_tool(question: str) -> str 。

uvxを使用してWindowsで実行する

Windowsでuvxを使用していて、 --from git+httpsで問題が発生する場合は、リポジトリをローカルにクローンし、 mcpServersにuvx.exeとクローンしたリポジトリへのフルパスを設定することをお勧めします。さらに、必要に応じてAPPDATA 、 LOGLEVEL 、その他の環境変数も設定してください。

MCP エコシステムの構成例 (Windows 上のmcpServers )

{
  "mcpServers": {
    "flowise": {
      "command": "C:\\Users\\matth\\.local\\bin\\uvx.exe",
      "args": [
        "--from",
        "C:\\Users\\matth\\downloads\\mcp-flowise",
        "mcp-flowise"
      ],
      "env": {
        "LOGLEVEL": "ERROR",
        "APPDATA": "C:\\Users\\matth\\AppData\\Roaming",
        "FLOWISE_API_KEY": "your-api-key-goes-here",
        "FLOWISE_API_ENDPOINT": "http://localhost:3010/"
      }
    }
  }
}

注記

• フルパス: uvx.exeとクローンされたリポジトリの両方にフルパスを使用します。

• 環境変数: 必要に応じて、 APPDATA Windows ユーザー プロファイル (例: C:\\Users\\<username>\\AppData\\Roaming ) にポイントします。

• ログ レベル: 必要に応じてLOGLEVEL調整します ( ERROR 、 INFO 、 DEBUGなど)。

環境変数

一般的な

• FLOWISE_API_KEY : Flowise API ベアラー トークン (必須)。

• FLOWISE_API_ENDPOINT : Flowise のベース URL (デフォルト: http://localhost:3010 )。

低レベルモード（デフォルト）

• FLOWISE_CHATFLOW_DESCRIPTIONS : chatflow_id:descriptionのペアのコンマ区切りリスト。例:

  FLOWISE_CHATFLOW_DESCRIPTIONS="abc123:Chatflow One,xyz789:Chatflow Two"

FastMCPモード（ FLOWISE_SIMPLE_MODE=true ）

• FLOWISE_CHATFLOW_ID : 単一のチャットフロー ID (オプション)。

• FLOWISE_ASSISTANT_ID : 単一アシスタント ID (オプション)。

• FLOWISE_CHATFLOW_DESCRIPTION : 公開される単一のツールのオプションの説明。

チャットフローのフィルタリング

次の環境変数を使用して、両方のモードでフィルターを適用できます。

• IDによるホワイトリスト:
  FLOWISE_WHITELIST_ID="id1,id2,id3"

• IDによるブラックリスト:
  FLOWISE_BLACKLIST_ID="id4,id5"

• 名前によるホワイトリスト（正規表現） :
  FLOWISE_WHITELIST_NAME_REGEX=".*important.*"

• 名前によるブラックリスト（正規表現） :
  FLOWISE_BLACKLIST_NAME_REGEX=".*deprecated.*"

注：ホワイトリストはブラックリストよりも優先されます。両方が設定されている場合は、最も制限の厳しいルールが適用されます。

安全

• API キーを保護する: FLOWISE_API_KEYが安全に保管され、ログやリポジトリに公開されないようにします。

• 環境構成: 機密性の高い構成には.envファイルまたは環境変数を使用します。

.gitignoreに.envを追加します:

# .gitignore
.env

トラブルシューティング

• API キーがありません: FLOWISE_API_KEYが正しく設定されていることを確認してください。

• 無効な構成: FLOWISE_CHATFLOW_IDとFLOWISE_ASSISTANT_IDの両方が設定されている場合、サーバーは起動を拒否します。

• 接続エラー: FLOWISE_API_ENDPOINTにアクセスできることを確認してください。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

やるべきこと

• [x] Fastmcpモード

• [x] 低レベルモード

• [x] フィルタリング

• [x] クロードデスクトップ統合

• [ ] アシスタント