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 集成
• [ ] 助手