Flowise

🚀 mcp-flowise

mcp-flowise 是一個集成 Flowise API 的 Model Context Protocol (MCP) 服務器的 Python 包。它提供了一種標準且靈活的方式來列出聊天流程、創建預測以及為 Flowise 聊天流程或助手動態註冊工具。

🚀 快速開始

mcp-flowise 支持兩種運行模式：

• 低級模式（默認）：為從 Flowise API 獲取的所有聊天流程或助手動態註冊工具。
• FastMCP 模式：提供靜態工具以列出聊天流程和創建預測，適用於更簡單的配置。

✨ 主要特性

• 動態工具暴露：低級模式為每個聊天流程或助手動態創建工具。
• 更簡單的配置：FastMCP 模式提供 list_chatflows 和 create_prediction 工具，實現最小化設置。
• 靈活的過濾：兩種模式均支持通過 ID 或名稱（正則表達式）對聊天流程進行過濾，使用白名單和黑名單。
• MCP 集成：與 MCP 工作流無縫集成。

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動化安裝：

# .gitignore
.env

📚 詳細文檔

環境變量

常規

• 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 文件或環境變量進行敏感配置。

將 .env 添加到 .gitignore：

# .gitignore
.env

故障排除

• 缺少 API 密鑰：確保 FLOWISE_API_KEY 設置正確。
• 無效配置：如果同時設置了 FLOWISE_CHATFLOW_ID 和 FLOWISE_ASSISTANT_ID，服務器將拒絕啟動。
• 連接錯誤：驗證 FLOWISE_API_ENDPOINT 是否可達。

📄 許可證

此項目根據 MIT 許可證發佈。有關詳細信息，請參閱 LICENSE 文件。

TODO

• [x] Fastmcp 模式
• [x] 低級模式
• [x] 過濾
• [x] Claude Desktop 集成
• [ ] 助手