Agent Swarm MCP Server Suite

关键词

LLM 协作MCP 服务插件工具管理代码索引OneDrive 集成

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了基于 MCP 的后端服务体系，除了提供一个多代理协作平台，还包含若干内置 MCP 服务器（如 Code Index、OneDrive）以及 MCP 客户端的封装，用于在后端管理、注册、启动与调用外部工具，向 LLM 客户端提供统一的资源、工具和提示模板。

  • 主要功能点

    • MCP 服务器核心能力：托管 Resources、注册与执行 Tools、定义和渲染 Prompt 模板，并通过 JSON-RPC 与客户端通信。
    • 资源与工具管理：内置的 Code Index、OneDrive 等 MCP 服务，以及通用的插件/工具框架，支持外部工具的发现、调用与结果回传。
    • 会话与上下文管理：对话历史、任务、Todo、项目切换、上下文切换等；可对代理进行状态、项目、任务等聚合展示。
    • 多传输协议支持：Streamable HTTP、SSE、WebSocket 等传输方式，确保 LLM 客户端的实时上下文服务能力。
    • 安全与认证：JWT 验证、路由授权、内置管理员账户、Token 校验等。
    • 插件与 MCP 服务器集成：插件（技能）可关联 MCP 服务器，自动暴露 MCP 工具并通过工具调用执行。

  • 安装步骤

    • 安装后端
      • 在 server 目录执行：npm install
    • 安装前端（若需要）
      • 在 client 目录执行：npm install
    • 启动服务
      • 进入 server 目录后，执行 npm start 启动 MCP 服务器
      • 客户端（如管理 UI）可根据需要执行 npm run dev 进行前端开发
    • 运行后访问
      • 默认为 http://localhost:3001 提供 API 接口，若与前端 UI 联动，请按实际端口配置

  • 服务器配置（MCP 客户端需要的连接信息）

    • MCP 客户端要与 MCP 服务器建立连接，典型配置需包含服务器名称、启动命令和参数等。以下为示例性描述信息，具体可根据部署环境调整。
    • 示例配置（描述性文本，不是代码块，方便理解）
      • serverName: Code Index
      • command: node
      • args: ["server/src/index.js"]
      • 说明: 该配置用于告诉 MCP 客户端在目标机器上如何启动 Code Index 的 MCP 服务。实际连接时，客户端会使用这些信息建立与 MCP 服务器的连接并调用工具。
    • 说明
      • 配置的 purpose 是帮助 MCP 客户端在运行时定位并连接到 MCP 服务器，执行工具调用等行为。仓库中已有内置 MCP 服务（Code Index、OneDrive）及其路由与启动逻辑，部署时请确保相应的服务器已启动并可访问。
    • 注：MCP 客户端配置并非必须在后端代码中显式写死，通常以部署时的外部化配置形式提供。此处给出的是一个便于理解和落地的描述性参考。

  • 基本使用方法

    • 启动与运维
      • 启动后端服务，MCP 服务器会自动加载内置服务、连接 MCP 服务、初始化数据库、准备任务循环等。
      • 使用 REST/WebSocket/API 进行资源、工具、插件、MCP 服务的创建、查询、调用和管理。
    • 如何扩展
      • 可以通过新增 MCP 服务实现、扩展技能、以及将外部服务接入 MCP 管理端进行统一调用。
    • 日常操作要点
      • 使用 /api/mcp-servers 查看已注册的 MCP 服务器及其状态
      • 使用 /api/code-index/mcp 或 /api/onedrive/mcp（若存在）来创建对应的 MCP 连接并启动工具发现
      • 使用 /api/leader-tools 相关端点获取领导工具的 Last Messages、状态等（如需要对接管理端）

  • 备注

    • 该实现包含了服务端核心逻辑、工具发现、MCP 服务器管理、Code Index/OneDrive 的 MCP 服务、以及对外 API 提供的路由。若用于生产，请确保环境变量、数据库、以及网络访问等配置正确。

服务器信息

访问项目