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: Clever Cloud Documentation MCP Server
インストール
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とクローンされたリポジトリの両方にフルパスを使用します。環境変数: 必要に応じて、
APPDATAWindows ユーザー プロファイル (例: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] クロードデスクトップ統合
[ ] アシスタント