Miroir MCP 服务器

关键词

模型上下文协议LLM 集成SSE 实时传输JSON-RPC 服务工具执行
  • 项目简介
    • Miroir MCP 服务器是一个后端服务，按照 MCP（Model Context Protocol）标准与客户端（如大语言模型驱动的应用）通信，向其提供资源数据访问、工具执行、以及可自定义的提示模板等能力。
  • 主要功能点
    • MCP 基本协议支持：通过 JSON-RPC 请求接收并返回响应，提供工具列表、工具调用以及资源访问等入口。
    • 资源与数据访问：托管和管理 Resource/模型相关的数据访问能力，方便 LLM 读取所需上下文。
    • 工具注册与执行：注册并执行外部功能或服务的工具，LLM 可以通过 MCP 调用这些工具。
    • 提示模板与渲染：定义并渲染 Prompt 模板，支持对话模式的可定制交互。
    • 会话与传输协议：包含会话管理、能力声明，并支持多种传输协议（如 SSE），用于与客户端建立稳定的通信通道。
    • 服务器端集成：内置与 miroi-core 及相关存储、域控制器的集成，能够通过域控制器执行动作并返回结果。
  • 安装步骤
    • 环境准备：搭建 Node.js 20+/18+ 环境，确保可以运行 TypeScript 项目。
    • 安装依赖：在仓库根或对应包中执行安装依赖的命令（如 npm install）。
    • 构建 MCP 服务包：进入 miroir-mcp 包所在目录，使用项目提供的构建工具（tsup/tsup.config.js）进行打包，生成 dist 目录。
    • 启动服务：
      • 通过 Node 直接执行打包产物，默认监听端口 3080，SSE 端点为 /sse，消息通道为 /message。
  • 服务器配置（MCP 客户端不可见的配置信息，供 MCP 服务端启动时使用；下列为配置示意，实际部署以服务器端产出与实现为准）
    • serverName: miroir-mcp
    • command: node
    • args: ["dist/index.js"]
    • 备注：MCP 服务默认端口为 3080，如需自定义请在实际部署时调整启动参数或通过环境变量覆盖端口设置。
  • 基本使用方法
    • 启动后，客户端通过 SSE 建立会话，随后通过 /message 发送 JSON-RPC 请求调用工具（tools/call）或请求工具列表（list_tools）。
    • 客户端可以通过工具描述获取可调用工具的输入结构，并以 JSON-RPC 请求格式提交调用。
    • MCP 服务端会返回标准的 JSON-RPC 响应，或者以文本内容形式输出工具执行结果的内容段。

服务器信息

访问项目