Adjutant MCP 服务器

关键词

模型上下文工具执行提示模板JSON-RPC后端服务

使用说明（简要且可操作，便于上手期快速集成 MCP 客户端）：

  • 项目简介

    • Adjutant 是一个面向多代理系统的后端服务，内置 MCP 服务器实现，负责托管资源、注册并执行工具以及管理和渲染提示模板，向 LLM 客户端提供统一的上下文和能力。

  • 主要功能点

    • 资源与数据访问：统一管理可供 LLM 客户端读取的资源（资源/数据集合）。
    • 工具注册与执行：注册可调用的外部功能（Tools），LLM 客户端可发起工具调用并获得结果。
    • Prompt 定义与渲染：定义和渲染可自定义的提示模板，支持不同交互场景的上下文注入。
    • MCP 协议对接：通过 JSON-RPC 规范接收请求并返回响应，服务器端负责会话管理和能力声明。
    • 多传输协作：支持 SSE、WebSocket、Stdio 等传输通道，与客户端建立稳定通信。
    • 会话与身份管理：提供会话生命周期与身份解析，确保安全、可扩展的上下文服务框架。

  • 安装与运行

    • 最简使用法：
      • 在仓库根目录执行并运行开发环境脚本（将后端、前端及 ngrok 一同启动，便于远程调试与访问）。
    • 逐步运行（可选方式）：
      • 进入后端目录，安装依赖并启动 MCP 服务器服务入口（实现文件通常位于后端的 TypeScript/JavaScript 服务中）。
      • 如需前端仪表盘与后端后台分离运行，可分别在后端与前端目录执行各自的开发服务，或使用仓库提供的一整套开发命令。
    • 关键依赖与环境：
      • Node.js 环境
      • 依赖安装（前后端分离或整包）

  • 服务器配置（用于 MCP 客户端建立连接的配置说明）

    • 服务器名称：adjutant-mcp
    • 启动命令（command）：node
    • 启动参数（args）：用于加载 MCP 服务器并指向配置/工作目录的参数，例如：["backend/dist/mcp-server.js","--config","/path/to/.mcp.json"]
    • 说明：MCP 客户端在连接 MCP 服务器时需要读取该服务器的名称、连接端口及传输协议等信息。配置文件（.mcp.json）中应包含服务器名称、连接地址、可用传输协议以及认证与会话策略等元信息，具体字段由 MCP 客户端实现方根据 MCP 的定义解析。

  • 基本使用方法

    • 连接与请求
      • 客户端通过配置好的连接地址与传输协议，以 JSON-RPC 的格式向 MCP 服务器发起请求，例如读取资源、调用工具、获取 Prompt 等。
    • 资源访问
      • 客户端可通过 MCP 提供的资源接口访问数据，完成数据读取、变换与注入上下文的能力。
    • 工具调用
      • 客户端可调用注册在 MCP 服务器上的工具，以实现对外部功能的访问（如外部服务、计算任务、查询等）。
    • 提示模板渲染
      • 客户端可请求模板渲染，以获得符合上下文需求的提示文本，支持自定义变体。
    • 会话与安全
      • MCP 服务器管理会话、能力声明及传输状态，确保多客户端并发安全访问。

  • 备注

    • 该仓库包含完整的后端 MCP 服务器实现及相关测试，具备 MCP 协议核心能力、适配多传输协议、以及与前端 dashboard 的协同工作能力。官方文档与测试覆盖了核心行为：资源、工具、Prompts 的注册/执行、JSON-RPC 请求/响应处理、会话与传输管理等。

服务器信息

访问项目