AgentMux MCP 服务器
使用说明(Markdown 格式)
-
项目简介
- AgentMux MCP 服务器是一套面向大型语言模型(LLM)的后端服务,遵循 Model Context Protocol(MCP)规范,提供资源托管与数据访问、工具注册与执行、Prompt 模板管理,以及面向 LLM 的上下文渲染能力。服务器通过 JSON-RPC 协议与客户端通信,支持多传输协议以实现在不同环境中的安全、可扩展的上下文服务。
-
主要功能点
- 资源与数据访问:集中管理可被 LLM 使用的资源与数据访问能力。
- 工具注册与执行:注册可供 LLM 调用的外部工具,并执行对应操作。
- Prompt 模板管理与渲染:定义、管理并渲染用于与 LLM 交互的提示模板。
- JSON-RPC 通信:统一的请求与响应格式,支持请求、响应及通知。
- 会话管理与能力声明:对会话状态、能力与服务范围进行声明与维护。
- 多传输协议支持:基于 MCP 的实现,理论上可扩展到标准输入输出、SSE、WebSocket 等传输方式。
- 安全与扩展性:设计考虑到安全、模块化和易扩展,便于接入多类 LLM 客户端。
-
설치步骤(安装与构建)
-
- 安装依赖:在仓库根目录执行安装命令安装所需依赖。
-
- 构建组件:执行构建命令以生成 MCP 服务端代码。
-
- 启动服务:启动 MCP 服务器、后端服务及前端仪表盘(若需要)。
-
-
服务器配置(MCP 客户端与 MCP 服务器的对接说明)
- MCP 服务器的启动命令及参数(客户端需要配置,以便建立连接):
- serverName: agentmux-mcp
- command: node
- args: ["dist/mcp-server/index.js", "--port", "3001"]
- 说明:MCP 服务器监听端口为 3001,提供 MCP 接入点和工具服务。客户端应通过 MCP 服务器的地址与端口建立连接,并使用给定的传输类型(如 http)与协议版本进行通信。
参考配置要点(JSON 格式,示意用语描述,不给出具体代码块): { "serverName": "agentmux-mcp", "command": "node", "args": ["dist/mcp-server/index.js", "--port", "3001"], "description": "MCP 服务端用于 Claude/Gemini 等客户端的工具与上下文服务,监听 3001 端口,提供 JSON-RPC 接口。" }
-
基本使用方法
- 启动 MCP 服务器后,确保后端服务可用并与 MCP 服务互动。
- 使用支持 MCP 的客户端(如 Claude Code、Gemini CLI 等)按 MCP 服务器地址配置并建立连接。
- 客户端通过 MCP 提供的工具接口执行外部功能、读取资源、获取 Prompts,形成对话上下文。