Flowise MCP服务器
](https://pypi.org/project/flowise-mcp/)    
MCP(模型上下文协议)服务器,使AI代理能够与 流动 实例。适用于Claude Desktop、VS Code GitHub Copilot、Cursor和其他MCP兼容客户端。
特性
- 流量管理:列出、创建、更新和删除聊天流和代理流
- 预测:向流发送消息并接收响应
- 流量分析:分析配置并提出改进建议
- 助手:列出并检查Flowise助理
- 文档存储:管理RAG的文档存储
- 向量运算:插入向量和查询向量存储
- 聊天记录:检索和删除对话历史记录
- 变量和工具:管理全局变量和工具
需求
- Python 3.10+或 紫外线 包管理器
- 具有API访问权限的正在运行的Flowise实例
安装
选项A:使用pip
pip install flowise-mcp选项B:使用紫外线(推荐)
# Install uv first if you don't have it
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh然后配置您的AI客户端以使用 uvx flowise-mcp (见下文)。
配置
环境变量
| 变量 | 描述 | 必填 |
|---|---|---|
FLOWISE_BASE_URL | 您的Flowise实例URL | 是 |
FLOWISE_API_KEY | 用于身份验证的API密钥 | 是 |
FLOWISE_TIMEOUT | 请求超时(秒)(默认值:60) | 否 |
获取Flowise API密钥
- 打开Flowise实例
- 前往“设置”>“API密钥”
- 创建新的API密钥或复制现有密钥
客户端设置
VS代码(GitHub副本)
需要使用GitHub Copilot的VS代码1.99+。
添加到 .vscode/mcp.json 在您的项目或用户设置(JSON)中:
{
"servers": {
"flowise": {
"command": "uvx",
"args": ["flowise-mcp"],
"env": {
"FLOWISE_BASE_URL": "https://your-flowise-instance.com",
"FLOWISE_API_KEY": "your-api-key"
}
}
}
}添加配置后重新启动VS Code。
克劳德桌面版
添加到您的配置文件中:
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"flowise": {
"command": "uvx",
"args": ["flowise-mcp"],
"env": {
"FLOWISE_BASE_URL": "https://your-flowise-instance.com",
"FLOWISE_API_KEY": "your-api-key"
}
}
}
}添加配置后重新启动Claude Desktop。
可用工具
流量管理
| 工具 | 说明 |
|---|---|
flowise_list_flows | 列出所有聊天流和代理流 |
flowise_get_flow | 获取详细的流程配置 |
flowise_create_flow | 创建新流 |
flowise_update_flow | 更新现有流 |
flowise_delete_flow | 删除流 |
flowise_predict | 向流发送消息 |
flowise_analyze_flow | 分析流程并获得改进建议 |
助手
| 工具 | 说明 |
|---|---|
flowise_list_assistants | 列出所有已配置的助手 |
flowise_get_assistant | 获取助手详细信息和配置 |
文档存储和矢量
| 工具 | 说明 |
|---|---|
flowise_list_document_stores | 列出所有文档存储 |
flowise_get_document_store | 获取文档存储详细信息 |
flowise_upsert_vector | 在流中插入/更新向量 |
flowise_query_vector_store | 在矢量存储中搜索文档 |
聊天和配置
| 工具 | 说明 |
|---|---|
flowise_get_chat_history | 获取对话历史记录 |
flowise_delete_chat_history | 删除对话历史记录 |
flowise_list_variables | 列出全局变量 |
flowise_list_tools | 列出可用工具 |
flowise_ping | 检查服务器连接 |
使用示例
"List all my agentflows"
"Send 'Hello' to flow abc123"
"Analyze flow xyz789 and suggest improvements for better accuracy"
"Create a new chatflow named 'Customer Support Bot'"
"Show me all document stores"
"Query the vector store for 'pricing information'"
"Delete chat history for flow abc123"
"List all assistants"发展
如果你想在本地贡献或运营:
git clone https://github.com/JuliDir/flowise-mcp.git
cd flowise-mcp
# Using uv
uv sync --extra dev
uv run pytest
# Or using pip
pip install -e ".[dev]"
pytest故障排除
| 问题 | 解决方案 |
|---|---|
| 服务器未出现 | 重新启动AI客户端 |
uvx 未找到 | 安装uv(见步骤1) |
| 连接错误 | 检查 FLOWISE_BASE_URL |
| 身份验证失败 | 验证 FLOWISE_API_KEY |
许可证
MIT许可证-请参阅 许可证 了解详情。
作者
朱利安 迪 罗科@JuliDir)
