Flowise Dev Agent MCP 服务器

使用说明(简要概要)

  • 项目简介
    • Flowise Dev Agent 的 MCP 服务器是一个自包含的后端服务,用以向大语言模型(LLM)客户端提供标准化的资源数据、可调用的外部工具,以及可渲染的提示模板,所有交互通过 JSON-RPC 协议实现。
  • 主要功能点
    • 资源管理与数据访问:服务器提供对 Flowise 资源与数据的集中访问与管理能力。
    • 工具注册与执行:内置 51 种工具,以 JSON-RPC 调用形式暴露,LLM 客户端可按需调用外部功能。
    • 提示模板(Prompts):定义与渲染可定制的提示模板,支持多种交互模式。
    • 会话与状态管理:维护会话、迭代、审计与编解码,提供版本与对话的可追踪性。
    • 安全与可扩展性:包含写操作的哈希校验(WriteGuard)、日志化、红action、以及本地/远程持久化选型(如 Postgres 与 SQLite 等)。
    • 协议与传输:MCP 层基于 JSON-RPC,底层实现具备日志、SSE/WebSocket 等传输能力的扩展潜力。
  • 安装与运行
    • 本地开发/部署优先使用 Docker(按仓库提供的部署脚本与环境变量模板搭建完整栈),也可在本地 Python 环境执行。
    • 运行入口通常为 python -m flowise_dev_agent.mcp,直接启动 MCP 服务。
  • 服务器配置(供 MCP 客户端使用的连接配置,示例用于 JSON 配置)
    • 配置格式为 JSON,包含服务名、启动命令与参数等信息,便于 Cursor IDE、Claude Desktop 等客户端将 MCP 服务器注册并对接。
    • 示例(请以实际环境变量与地址替换): { "mcpServers": { "flowise": { "command": "python", "args": ["-m", "flowise_dev_agent.mcp"], "env": { "FLOWISE_API_KEY": "your-flowise-api-key", "FLOWISE_API_ENDPOINT": "http://localhost:3000" } } } }
    • 说明:该配置用于 MCP 客户端建立与 MCP 服务器的连接,包含服务器名称、启动命令、启动参数与必要的环境变量;客户端在初始化时会读取并连接到该服务器。实际使用中,确保 FLOWISE_API_ENDPOINT、FLOWISE_API_KEY 等环境变量配置正确,并视本地/云端部署调整端口与地址。
  • 基本使用方法
    • 启动:在服务器所在环境执行 MCP 服务器入口命令,默认监听 JSON-RPC 请求,准备好对外服务。
    • 连接测试:通过客户端发送标准 MCP 请求(如资源读取、工具调用、Prompts 获取等),服务端返回 JSON-RPC 的响应结果或事件通知。
    • 运行与运维:关注会话状态、工具调用情况、以及日志输出;必要时结合 Postgres/SQLite 进行持久化与审计。
  • 其他注意
    • MCP 服务端与 Flowise 的 API、节点/工具内部实现紧密耦合,需确保 Flowise 实例的可用性与密钥/API 端点正确性。
    • 配置中涉及的 Secrets(如 API KEY/凭证)应避免提交到版本库,使用环境变量或安全凭证管理方式。

服务器信息