Claude Sidecar MCP 服务器

关键词

上下文服务JSON-RPC并行推理工具执行会话管理

使用说明（Markdown 格式）

  • 项目简介

    • Claude Sidecar MCP 服务器是一套完整的后端服务，遵循 MCP 标准，旨在通过标准化的 JSON-RPC 协议向 LLM 客户端提供资源管理、工具注册与执行、以及 Prompt 模板渲染等能力。服务器负责会话生命周期、能力声明，以及对多种传输协议的支持，为多模型协同提供统一的上下文服务框架。

  • 主要功能点

    • 资源托管与数据访问：集中管理可供模型访问的资源（如代码、模型配置、会话上下文等）。
    • 工具注册与执行：暴露可由 LLM 调用的外部工具，支持参数传递与结果回传。
    • Prompt 定义与渲染：提供可定制的 Prompt 模板，便于不同交互模式下的对话设计。
    • JSON-RPC 通信：服务器与客户端通过 JSON-RPC 进行请求与响应的通信。
    • 会话管理与能力声明：维护会话上下文、访问权限、以及模型能力的自描述能力。
    • 多传输协议支持：实现对 Stdio、SSE、WebSocket 等传输协议的支持，提升嵌入式应用场景的灵活性。
    • MCP 集成：与 Claude Desktop/Cowork 的内置 MCP 注册、发现与协作能力紧密配合。

  • 安装步骤

    • 获取源码并安装依赖（通常通过 npm/yarn 安装）。
    • 使用内置的 MCP 服务器实现直接启动 MCP 服务，或通过外部进程对接（详见下方服务器配置与启动方式）。
    • 运行 MCP 服务器后，MCP 客户端即可通过约定的 JSON-RPC 请求来读取资源、调用工具、获取并渲染 Prompts。

  • 服务器配置（MCP 服务器的启动信息）

    • MCP 客户端需要的仅是启动信息，用于通过客户端启动并连接到 MCP 服务器。配置通常以 JSON 形式描述，包含服务器名称、启动命令以及参数等。示例说明如下（请据实际部署修改路径与参数）：
    • 服务器名称：sidecar
    • 启动命令（command）：node
    • 启动参数（args）：["/path/to/sidecar/bin/sidecar.js", "mcp"]
    • 说明：该配置表示通过 Node 启动 Claude Sidecar 的 MCP 服务端，传入 mcp 子命令以进入 MCP 模式。实际路径需要填写你本地环境中 sidecar 的 bin 目录及启动脚本位置。该信息是 MCP 客户端需要的连接描述，具体细节由客户端在运行时解析并使用。
    • 完整配置（非代码区块描述，文本示例）：
      • 名称: sidecar
      • 命令: node
      • 参数: ["/path/to/sidecar/bin/sidecar.js", "mcp"]
      • 启动说明: 使用 Node 解释执行 sidecar.js 的 mcp 模式以提供 MCP 服务
      • 备注: 客户端无需知道内部实现细节，仅需遵循该启动描述完成连接

  • 基本使用方法

    • 启动 MCP 服务后，客户端通过 JSON-RPC 请求与之通信，支持读取资源、执行工具、获取并渲染 Prompts 等能力。
    • 会话管理：客户端可创建、读取、继续、折叠等会话，服务器负责在磁盘或持久化存储中维护会话状态。
    • 安全与扩展性：具备能力声明、权限控制，以及对多种传输协议的支持，便于在不同环境中部署与扩展。

  • 注意事项

    • MCP 客户端需要的仅是对启动命令与参数的描述（如上所示的 JSON 配置），实际的接口调用、吞吐量、并发等性能参数需根据实际部署进行调优。
    • 由于实现包含大量服务端逻辑（资源、工具、提示模板、会话、ACL、传输协议等），请确保运行环境具备所需的 Node.js 版本与依赖。

服务器信息

访问项目