MCP 服务器

mcp-flowise

Flowise MCP 服务器使客户端能够列出 Chatflow 并调用预测，与 DIY Flowise 或 Flowise Cloud 帐户无缝集成。它提供了一个简单的界面，用于使用现有的 Flowise 配置执行 Chatflow/助手预测。

README

mcp-flowise

mcp-flowise 是一个 Python 包，实现了与 Flowise API 集成的模型上下文协议 (MCP) 服务器。它提供了一种标准化且灵活的方式来列出 chatflow、创建预测以及为 Flowise chatflow 或助手动态注册工具。

它支持两种操作模式：

LowLevel 模式（默认）：为从 Flowise API 检索的所有 chatflow 动态注册工具。
FastMCP 模式：提供用于列出 chatflow 和创建预测的静态工具，适用于更简单的配置。

特性

动态工具暴露：LowLevel 模式为每个 chatflow 或助手动态创建工具。
更简单的配置：FastMCP 模式暴露 list_chatflows 和 create_prediction 工具，以实现最小化设置。
灵活的过滤：两种模式都支持通过 ID 或名称（正则表达式）使用白名单和黑名单来过滤 chatflow。
MCP 集成：无缝集成到 MCP 工作流程中。

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 mcp-flowise，请执行以下操作：

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

前提条件

Python 3.12 或更高版本
uvx 包管理器

通过 `uvx` 安装和运行

确认您可以使用 uvx 直接从 GitHub 存储库运行服务器：

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

添加到 MCP 生态系统（`mcpServers` 配置）

您可以通过将其添加到 mcpServers 配置中，将 mcp-flowise 集成到您的 MCP 生态系统中。示例：

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

操作模式

1. FastMCP 模式（简单模式）

通过设置 FLOWISE_SIMPLE_MODE=true 启用。此模式：

暴露两个工具：list_chatflows 和 create_prediction。
允许使用 FLOWISE_CHATFLOW_ID 或 FLOWISE_ASSISTANT_ID 进行静态配置。
通过 list_chatflows 列出所有可用的 chatflow。

2. LowLevel 模式 (FLOWISE_SIMPLE_MODE=False)

特性：

将所有 chatflow 动态注册为单独的工具。
工具以 chatflow 名称（规范化）命名。
使用 FLOWISE_CHATFLOW_DESCRIPTIONS 变量中的描述，如果没有提供描述，则回退到 chatflow 名称。

示例：

为 chatflow 动态创建 my_tool(question: str) -> str。

在 Windows 上使用 `uvx` 运行

如果您在 Windows 上使用 uvx 并且遇到 --from git+https 问题，建议的解决方案是克隆本地存储库，并使用 uvx.exe 的完整路径和克隆的存储库配置 mcpServers。此外，根据需要包含 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:3000/"
      }
    }
  }
}

注意事项

完整路径：使用 uvx.exe 和克隆存储库的完整路径。
环境变量：如果需要，将 APPDATA 指向您的 Windows 用户配置文件（例如，C:\\Users\\<username>\\AppData\\Roaming）。
日志级别：根据需要调整 LOGLEVEL（ERROR、INFO、DEBUG 等）。

环境变量

常规

FLOWISE_API_KEY：您的 Flowise API Bearer 令牌（必需）。
FLOWISE_API_ENDPOINT：Flowise 的基本 URL（默认值：http://localhost:3000）。

LowLevel 模式（默认）

FLOWISE_CHATFLOW_DESCRIPTIONS：以逗号分隔的 chatflow_id:description 对列表。示例：
```
FLOWISE_CHATFLOW_DESCRIPTIONS="abc123:Chatflow One,xyz789:Chatflow Two"
```