AgentMux MCP 服务器

使用说明(Markdown 格式)

  • 项目简介

    • AgentMux MCP 服务器是一套面向大型语言模型(LLM)的后端服务,遵循 Model Context Protocol(MCP)规范,提供资源托管与数据访问、工具注册与执行、Prompt 模板管理,以及面向 LLM 的上下文渲染能力。服务器通过 JSON-RPC 协议与客户端通信,支持多传输协议以实现在不同环境中的安全、可扩展的上下文服务。
  • 主要功能点

    • 资源与数据访问:集中管理可被 LLM 使用的资源与数据访问能力。
    • 工具注册与执行:注册可供 LLM 调用的外部工具,并执行对应操作。
    • Prompt 模板管理与渲染:定义、管理并渲染用于与 LLM 交互的提示模板。
    • JSON-RPC 通信:统一的请求与响应格式,支持请求、响应及通知。
    • 会话管理与能力声明:对会话状态、能力与服务范围进行声明与维护。
    • 多传输协议支持:基于 MCP 的实现,理论上可扩展到标准输入输出、SSE、WebSocket 等传输方式。
    • 安全与扩展性:设计考虑到安全、模块化和易扩展,便于接入多类 LLM 客户端。
  • 설치步骤(安装与构建)

      1. 安装依赖:在仓库根目录执行安装命令安装所需依赖。
      1. 构建组件:执行构建命令以生成 MCP 服务端代码。
      1. 启动服务:启动 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,形成对话上下文。

服务器信息