mcp-flowise

mcp-flowise

site icon
2025.01.31 23
PythonFlowise 集成动态工具注册聊天流程管理开发效率
mcp-flowise 是一个实现模型上下文协议(MCP)服务器的 Python 包,集成了 Flowise API。它提供了一种标准化且灵活的方式来列出聊天流程、创建预测,并为 Flowise 聊天流程或助手动态注册工具。支持两种操作模式:低级别模式(默认)和 FastMCP 模式。
View on GitHub

Overview

基本能力

产品定位

mcp-flowise 是一个用于集成 Flowise API 的 MCP 服务器,旨在为聊天流程和助手提供动态工具注册和预测功能。

核心功能

  • 动态工具暴露:低级别模式为每个聊天流程或助手动态创建工具。
  • 简化配置:FastMCP 模式提供 list_chatflowscreate_prediction 工具,适用于简单配置。
  • 灵活过滤:支持通过 ID 或名称(正则表达式)进行白名单和黑名单过滤。
  • MCP 集成:无缝集成到 MCP 工作流中。

适用场景

  • 需要动态注册工具的 Flowise 聊天流程或助手。
  • 需要简化配置的 Flowise 集成场景。
  • 需要灵活过滤聊天流程的场景。

工具列表

  • list_chatflows:列出所有可用的聊天流程。
  • create_prediction:为指定的聊天流程创建预测。
  • 动态工具:在低级别模式下,为每个聊天流程动态创建工具。

常见问题解答

  • 缺少 API 密钥:确保 FLOWISE_API_KEY 正确设置。
  • 无效配置:如果同时设置了 FLOWISE_CHATFLOW_IDFLOWISE_ASSISTANT_ID,服务器将拒绝启动。
  • 连接错误:验证 FLOWISE_API_ENDPOINT 是否可达。

使用教程

使用依赖

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

安装教程

通过 Smithery 安装

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

通过 uvx 安装和运行

uvx --from git+https://github.com/matthewhand/mcp-flowise 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}"
            }
        }
    }
}

调试方式

  • 确保 FLOWISE_API_KEYFLOWISE_API_ENDPOINT 正确设置。
  • 检查日志以获取错误信息。
  • 验证 uvx 是否正确安装并运行。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。