使用说明
项目简介
RuleGo-Server 是一个基于 RuleGo 构建的轻量级、高性能、模块化和易于集成的自动化工作流平台。它不仅可以用于自动化编排、iPaaS、API 编排和数据处理等多种场景,还通过支持 MCP 协议,为 AI 助手提供强大的工具扩展能力,实现与应用系统的深度集成。
主要功能点
- MCP 协议支持: RuleGo-Server 实现了 Model Context Protocol (MCP) 服务器,能够以标准化的方式向 LLM 客户端提供上下文信息和功能,使 AI 助手能够直接调用平台的功能。
- 自动化工作流编排: 提供可视化界面和低代码方式进行规则链(工作流)的设计、管理和执行。
- 丰富的组件库: 内置超过 100 种组件,并支持动态安装组件市场和规则链市场的组件,方便用户扩展功能。
- AI 助手集成: 自动将注册的组件、规则链和 API 转化为 MCP 工具,供 AI 助手(如 Windsurf、Cursor、Codeium 等)调用。
- 多租户支持: 支持多用户环境,每个用户拥有独立的工作流数据,保障数据隔离和安全。
- 灵活的 HTTP API: 提供完善的 HTTP API 接口,方便与现有系统集成和管理。
安装步骤
- 下载仓库: 从 GitHub 克隆 RuleGo-Server 仓库到本地。
git clone https://github.com/rulego/rulego-server.git cd rulego-server - 编译服务器: 进入 'cmd/server' 目录,使用 Go 编译服务器程序。
如果需要包含扩展组件,可以使用 'tags' 进行编译,例如包含 AI 扩展组件:cd cmd/server go build .go build -tags with_ai . - 启动服务器: 编译成功后,运行服务器程序,并指定配置文件路径。
或者在后台运行:./server -c="./config.conf"nohup ./server -c="./config.conf" >> console.log &
服务器配置
MCP 服务器配置位于 'config.conf' 文件的 '[mcp]' सेक्शन。以下是 MCP 客户端连接和使用 RuleGo-Server MCP 服务器所需的配置信息(JSON 格式):
{ "serverName": "RuleGo-Server MCP Server", // MCP 服务器名称,可自定义 "command": "./server", // MCP 服务器启动命令,根据实际路径调整 "args": ["-c", "./config.conf"], // 启动参数,指定配置文件路径 "transport": "sse", // 传输协议,RuleGo-Server MCP 服务器默认支持 SSE "apiKey": "YOUR_API_KEY" // API 密钥,用于身份验证,需要替换为实际用户的 API Key }
参数注释:
- 'serverName': MCP 服务器的名称,客户端显示用,可以自定义。
- 'command': 启动 RuleGo-Server 服务器的可执行文件路径,根据实际编译后的文件位置填写。
- 'args': 启动 RuleGo-Server 服务器的命令行参数,'-c' 参数指定配置文件路径,请确保指向正确的 'config.conf' 文件。
- 'transport': 指定 MCP 客户端与服务器通信的传输协议,RuleGo-Server MCP 服务器支持 SSE (Server-Sent Events)。
- 'apiKey': 重要,用于 MCP 客户端身份验证的 API 密钥。需要替换为 RuleGo-Server 中配置用户的实际 API Key。 可以在 'config.conf' 文件的 '[users]' 部分配置用户及其 API Key,例如:
请将 'YOUR_API_KEY' 替换为您设置的 API Key,并在客户端配置中使用 'admin' 用户的 API Key。[users] admin = admin,YOUR_API_KEY
基本使用方法
- 配置 MCP 客户端: 在 MCP 客户端中,配置上述 JSON 格式的服务器连接信息,并确保 'apiKey' 配置正确。
- 连接 MCP 服务器: 启动 RuleGo-Server 后,MCP 客户端应能成功连接到服务器。
- 发现和调用工具: MCP 客户端连接成功后,可以发现 RuleGo-Server 提供的 MCP 工具,这些工具包括:
- 组件工具: RuleGo-Server 注册的内置和扩展组件,例如 'delay', 'log', 'dbClient' 等,可以直接被 AI 助手调用执行特定功能。
- 规则链工具: 用户在 RuleGo-Server 中创建的规则链,可以作为工具被 AI 助手调用,执行复杂的工作流逻辑。
- API 工具: RuleGo-Server 提供的规则链管理 API,例如 'listRuleChain', 'saveRuleChain', 'executeRuleChain' 等,允许 AI 助手进行规则链的查询、创建、执行等操作。
- 通过 AI 助手调用工具: 在支持 MCP 协议的 AI 助手(如 Windsurf、Cursor、Codeium 等)中,即可通过自然语言指令调用 RuleGo-Server 提供的工具,实现与后端应用系统的集成和交互。
注意:
- 确保 'config.conf' 文件中 '[mcp]' 部分的 'enable = true',以启用 MCP 服务。
- 根据实际需求配置 '[mcp]' 部分的其他参数,例如 'load_components_as_tool', 'load_chains_as_tool', 'load_apis_as_tool' 等,以控制哪些功能作为 MCP 工具暴露给 AI 助手。
- 详细的 MCP 工具列表和使用方法,请参考 RuleGo-Server 的官方文档和 MCP 客户端的相关文档。
信息
分类
开发者工具