Easy Proxy MCP 服务端 (代理+插件生态的后端服务)
使用说明(Markdown 格式)
- 项目简介
- Easy Proxy 的后端服务实现了一个与 MCP 规范对接的服务器端,负责托管路由规则、Mock 规则、以及插件体系等能力,并通过 MCP 的 JSON-RPC 协议与客户端进行交互。
- 主要功能点
- MCP 服务端核心对接:通过 JSON-RPC 提供工具注册、资源管理、以及插件能力的入口。
- 路由与 Mock 管理:内置路由规则、Mock 规则的创建、修改、查询等接口,支持热更新与文件持久化。
- 插件系统:包含内置插件与可动态加载的自定义插件框架,支持插件生命周期、Hook 调用与健康统计。
- AI 插件生成功能:能通过 AI 自动生成符合规范的插件代码,支持流式输出和自动编译。
- WebSocket 与 HTTP/2/HTTPS 支持:代理请求支持多种传输协议,具备对后端目标的转换与优化能力。
- 诊断与状态视图:提供对系统健康、配置信息、以及运行时状态的诊断与汇总。
- 安装与运行
- 本仓库包含服务端 MCP 实现及一个功能完备的代理服务,运行核心入口在 mcp-server.js(MCP 服务端)以及 index.js(代理服务端核心)。
- 运行前请确保已安装 Node.js 环境,建议在项目根目录执行:node mcp-server.js 启动 MCP 服务端,或通过 MCP 客户端配置对接。
- 服务器配置示例(MCP 客户端需要的配置,非运行代码)
- MCP 客户端在连接该服务器时,需通过以下 JSON 形式的配置来指定要连接的 MCP 服务端信息(serverName、command、args 等)。示意如下(请按实际环境替换路径与参数): { "mcpServers": { "easy-proxy": { "command": "node", "args": ["/path/to/easy-proxy/mcp-server.js"] } // 以上示例为标准用法,若实际路径不同,请改为正确的 mcp-server.js 路径 } }
- 注释说明:
- serverName: 服务器名称标识,用于在多服务场景中区分不同的 MCP 服务端。
- command: 启动命令,通常为 node。
- args: 启动参数,包含 MCP 服务端入口脚本的绝对路径。
- 该配置仅用于 MCP 客户端对接,实际 MCP 客户端无需理解服务器内部实现细节。
- 基本使用方法
- 启动 MCP 服务端后,通过 MCP 客户端发送标准化请求(如注册工具、读取资源、执行工具、获取 Prompts 等),服务端将返回 JSON-RPC 风格的响应或通知。
- 支持热更新、插件扩展、以及 AI 生成的插件代码,提升后端能力的灵活性与扩展性。