使用说明内容（Markdown格式）

项目简介
- Mosaic 的 MCP 服务端实现核心在于将 ClaudeCode 等节点暴露为 MCP 工具服务，LLM 客户端可以通过 JSON-RPC 风格的请求调用这些工具、读取资源、获取提示模板等功能。服务器与客户端通过标准化协议通信，支持会话和跨节点调用，搭建一个可扩展的上下文服务框架。
主要功能点
- 暴露 MCP 工具：为 ClaudeCode 等节点提供 MCP 工具接口，LLM 可以通过工具调用执行跨节点功能（如发送消息、邮件等）。
- 会话与路由：内置会话管理，支持通过会话在不同节点间传递上下文和路由信息。
- 事件网格整合：与 ZeroMQ/自定义事件体系集成，工具调用与事件在网格中流转。
- 安全与扩展性：通过配置化的 MCP 服务实现，便于接入更多节点与工具，具备基本的鉴权与可扩展性设计。
安装步骤
- 依赖安装：在具备 Python 环境的前提下安装所需依赖。
- 启动 MCP 服务端（后端服务器）：使用底层服务器入口启动，通常通过 UVicorn 启动 mosaic.refactor.backend.main:app，监听指定主机与端口。
- 启动 ClaudeCode 节点：配置 ClaudeCode 节点以暴露 MCP 工具（通过 mosaic-mcp-server），使其能够通过 MCP 调用其他节点工具。
- 集成客户端：MCP 客户端按照服务器配置（下方示例）启动并连接，向服务器发送 JSON-RPC 风格的请求。
服务器配置（给 MCP 客户端的配置示例，不是代码，仅供参考）
- 配置名称：mosaic-mcp-server
- 启动命令（command）：uvicorn
- 启动参数（args）：
  - mosaic.refactor.backend.main:app
  - --host
  - 0.0.0.0
  - --port
  - 8000 说明：上述配置表示通过 UVicorn 启动 FastAPI 应用（入口为 mosaic.refactor.backend.main:app），监听所有接口的 8000 端口。MCP 客户端通过该服务器来访问暴露的 MCP 工具接口。transport 建议采用 stdio 或 tcp，具体以客户端实现需求为准。
基本使用方法
- 启动服务端后，MCP 客户端加载服务器配置，连接 MCP 服务器。
- 调用 MCU 工具时，客户端发起带有 tool 名称、参数和上下文的 JSON-RPC 请求，服务器解析并执行相应工具，返回结果。
- 会话管理与路由由服务端负责，确保跨节点消息与事件能够正确传递并落库。

关键词

信息