mcp-flowise

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 ワークフローにシームレスに統合します。

インストール

Smithery経由でインストール

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

前提条件

• Python 3.12以上
• uvxパッケージマネージャー

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

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

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

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

動作モード

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 )

注記

• フルパス: 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:3000 )。

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

• 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を追加します:

トラブルシューティング

• API キーがありません: FLOWISE_API_KEYが正しく設定されていることを確認してください。
• 無効な構成: FLOWISE_CHATFLOW_IDとFLOWISE_ASSISTANT_IDの両方が設定されている場合、サーバーは起動を拒否します。
• 接続エラー: FLOWISE_API_ENDPOINTにアクセスできることを確認してください。

ライセンス

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

やるべきこと

• [x] Fastmcpモード
• [x] 低レベルモード
• [x] フィルタリング
• [x] クロードデスクトップ統合
• [ ] アシスタント