OmniSpecialist MCP 服务器

使用说明内容(Markdown格式)

  • 项目简介

    • OmniSpecialist 是一个 MCP 服务器实现,旨在让大型语言模型(如 Claude、其他代理)能够发现、调用和管理专门化的代理(Specialists),并提供可访问的资源、工具和 Prompt 模板,以实现更强大的自动化和推理能力。
  • 主要功能点

    • 资源托管与访问:管理面向 LLM 的数据资源,提供统一的数据访问能力。
    • 工具注册与执行:注册可供 LLM 调用的外部工具,支持同步与异步执行,以及并行/流水线处理。
    • Prompt 模板定义与渲染:定义系统提示、任务模板和渲染策略,适配不同的交互模式。
    • 多传输协议支持:通过不同传输渠道与客户端通信(如标准输入/输出、Server-Sent Events、WebSocket 等)。
    • 会话管理与能力声明:维护会话状态、能力清单,确保安全可控的任务执行。
    • 与 MCP 客户端的 JSON-RPC 通信:通过标准的 JSON-RPC 请求/响应与客户端对接,提供资源读取、工具调用、Prompt 获取等能力。
    • 内置与可扩展的 Specialists:支持跨作用域(项目、用户、系统)的 Specialists 配置与运行。
    • 一体化安装与集成:提供一键安装脚本和在 Claude 生态中加载 MCP 的集成步骤。
  • 安装步骤

    • 一键安装(推荐)
      • 运行命令:npx --package=@jaggerxtrm/specialists install
      • 该过程会安装 MCP 运行所需的运行时和工具、注册 MCP、并在用户目录下创建专属 Specialists 目录。安装完成后建议重启 Claude Code 等环境以加载 MCP。
    • 手动安装
      • 全局安装:npm install -g @jaggerxtrm/specialists
      • 按照仓库 README 的指示,将 Specialists MCP 注册到 Claude 的 MCP 管理中(示例:claude mcp add --scope user specialists -- specialists),随后重启 Claude Code。
  • 服务器配置(给 MCP 客户端的说明,配置以 JSON 形式描述,实际客户端不需要包含在此处代码块中)

    • serverName: specialists
    • command: node
    • args: ["dist/index.js"]
    • transports: ["stdio", "sse", "websocket"] 说明:该服务器通过 Node 运行,dist/index.js 是入口脚本,支持多种传输协议以和 MCP 客户端进行通信。
    • 说明与注解:以上信息用于 MCP 客户端在启动时了解服务器标识、启动命令和可用传输通道,便于在不同环境中接入与对接。实际使用时客户端只需要知道服务器名称、启动命令及参数,后续的资源、工具和 Prompts 交互由服务器主动处理。
  • 基本使用方法

    • 启动与接入
      • 安装完成后,按照仓库提供的集成流程将 MCP 加载到您的 Claude 环境中,重启开发环境以使服务器就绪。
    • 资源与工具的使用
      • 通过 MCP 客户端发起对资源的读取、对工具的调用、以及对 Prompt 的获取。
      • 服务器将返回标准化的 JSON-RPC 响应,包含结果数据或错误信息。
    • 任务编排与代理协作
      • 服务器暴露的 Tools 可以让 LLM 将复杂任务分发给合适的 Specialist,并支持并行/流水线执行。
    • 安全与扩展
      • 服务器实现会话管理、能力声明与权限分级,确保任务执行的安全边界,便于后续扩展新 Specialist、Prompts 与 Tools。
  • 运行要点

    • 服务器依赖 Node.js 环境,dist/index.js 作为入口执行。
    • 如需在不同环境部署,请确保传输通道(stdio/SSE/WebSocket)可用,且对应端口/通道配置正确。
  • 注意事项

    • MCP 客户端(如 Claude)在连接 MCP 服务器时需要提供启动命令和参数,具体连接流程与参数由 MCP 客户端实现方负责,不在本说明中展开。

服务器信息