OmniSpecialist MCP 服务器

使用说明（Markdown）

• 项目简介

  • OmniSpecialist 是一个 MCP 服务器实现，核心职责是向 LLM 客户端以标准化方式暴露资源、工具与提示模板等上下文信息与功能。它通过 JSON-RPC 形式处理 MCP 请求，支持工具发现、执行以及对话上下文的管理，便于将专业化代理（specialists）接入到 LLM 的工作流中。

• 主要功能点

  • MCP 请求处理：实现 ListTools 请求与 CallTool 请求等核心 MCP JSON-RPC 通信，规范化返回工具信息与执行结果。
  • 工具注册与执行：注册并执行外部工具，提供执行进度回传、错误处理与结果返回机制，支持多工具并发或流水线执行。
  • 资源与工具管理：托管与管理资源、工具定义，提供工具清单、状态查询等能力。
  • Prompt 模板定义与渲染：支持提示模板的定义、系统提示注入、任务模板组合等，便于 LLM 进行上下文驱动的交互。
  • 会话与传输协议：服务器端负责会话管理、能力声明，当前实现支持 Stdio 传输，未来可扩展为 SSE、WebSocket 等传输。

• 安装步骤

  • 确保系统环境满足运行要求（Node.js 18+，如使用 Bun 则按仓库指南执行 bun install）。
  • 安装依赖并构建代码（按照仓库提供的开发步骤，通常是安装依赖、编译生成 dist 目录下的 entry）。
  • 启动 MCP 服务器进程，或按照全局安装方案将服务器注册到 Claude（或其他 MCP 客户端）配置中，服务器将监听并响应 MCP 客户端的 JSON-RPC 请求。
  • 如需将服务器加入 Claude 的 MCP 列表，可使用仓库提供的安装脚本（bin/install.js）等工具进行全局安装与注册，完成后 restart Claude Code 以加载 MCP。

• 服务器配置 注：以下配置信息用于 MCP 客户端建立与服务器的连接，客户端本身并不需要修改；配置示例以仓库信息为基础给出可读描述。

  • server name: unitAI
  • 启动命令: node
  • 启动参数（示例路径）：<全局安装路径>/omnispecialist/dist/index.js 说明：MCP 客户端通过该启动信息知道如何启动 MCP 服务器进程并进行 JSON-RPC 通信。请将路径替换为实际全局安装后服务器入口脚本的实际路径。

• 基本使用方法

  • 启动服务器后，MCP 客户端便可通过 JSON-RPC 请求 ListTools 获取可用工具清单，通过 CallTool 调用具体工具并获取结果。
  • 客户端可查询工具状态、轮询任务进度、并发执行等。
  • 结合现有工具（如 Specialist 工作流、Cursor Agent、Droid 等），可实现对复杂任务的自动化分派和执行。

• 运行与测试建议

  • 使用仓库提供的测试用例和工作流脚本验证 MCP 请求的完整性与正确性。
  • 在本地或 CI 环境中执行构建、启动、以及简单的 ListTools / CallTool 测试，确保输出与预期一致。