Claude Code Tool Manager MCP Gateway

关键词

模型上下文协议懒加载网关JSON-RPC后端管理Rust

使用说明（简要、面向开发者和运维人员）

  • 项目简介

    • 该仓库实现了一个完整的 MCP 服务器生态，包含一个以网关为核心的懒加载后端管理组件，以及一个可运行的 MCP 服务端框架，旨在为大语言模型客户端提供统一的上下文资源、工具执行能力和 Prompt 渲染能力。核心通过 JSON-RPC 风格的通信实现，支持多种传输协议。

  • 主要功能点

    • 资源管理：提供资源（Resources）的托管与数据访问能力，用于提供上下文所需的数据。
    • 工具注册与执行：注册可被 LLM 调用的工具，支持对接外部服务或后端MCP的工具集合，并可通过网关下发执行请求。
    • Prompt 模板定义与渲染：支持按需渲染与应用提示模板，方便统一的 LLM 交互模式。
    • MCP 网关（Gateway）与后端管理：实现一个懒加载的网关服务器，延迟建立与 MCP 的连接，只在需要时加载工具、执行工具，降低系统开销。
    • JSON-RPC 通信：通过标准的 JSON-RPC 封装进行请求/响应交互，便于与不同的 MCP 客户端对接。
    • 多传输协议支持：提供 stdio、HTTP/SSE 等传输方式，以适配不同后端 MCP 的实现。
    • 会话与状态管理：内置会话管理、服务端能力声明、以及在启动、停止、重载等场景下的状态协调。
    • 集成的本地应用架构：作为桌面应用的一部分，内置数据库、配置同步以及对外部工具的集成能力，便于开发和测试。

  • 安装与运行

    • 依赖与环境：
      • 需要 Rust、Node.js、以及 tauri 构建环境（同仓库自述的构建步骤）。
    • 构建与启动（开发/生产环境皆适用）：
      • 克隆仓库后，按照 README 的构建步骤在本地完成构建与打包（包含 Rust、Node、Taura 相关依赖）。
      • 以桌面应用形式运行 Claude Code Tool Manager，该应用内置 MCP 网关与 MCP 服务器功能模块，端口默认设置在代码中可配置，启动后应用会按配置自动启动网关与后端服务（如启用自动启动）。
    • 测试运行（开发阶段）
      • 运行 tauri 开发模式后，应用将暴露一个 MCP 网关端点，默认端口用于网关服务，后端 MCP 将在需要时被懒加载。

  • 服务器配置（JSON 配置示例，供 MCP 客户端参考） 注意：下面的配置用于指引 MCP 客户端如何连接到网关/服务器。实际启动通常由应用在本地直接运行提供服务，客户端配置不需要执行端口绑定等操作。 服务器名称与连接信息示例： { "serverName": "Claude Code Tool Manager Gateway", "type": "http", "url": "http://127.0.0.1:23848/mcp", "notes": "网关地址，MCP 客户端将通过该 URL 与网关交互。端口号如有调整，请在应用设置中修改。" } 说明：

    • serverName：服务器在客户端侧显示的名称，方便区分不同的后端服务。
    • type：传输类型，网关使用 HTTP 传输进行 MCP 请求/响应。
    • url：MCP 请求的目标地址，网关在指定端口暴露 /mcp 路径。
    • notes：补充说明，便于运维理解配置含义。

  • 基本使用方法

    • 启动：通过 Claude Code Tool Manager 应用启动 MCP 网关与后端服务。
    • 发现与加载：在网关中可看到可用的 MCP（懒加载逻辑），通过“加载工具”对指定 MCP 进行连接与工具加载。
    • 调用工具：在网络或本地后端中选择某个 MCP 的工具，发送执行请求，网关将返回执行结果（文本、图片、资源等内容）。
    • 配置同步：应用内的配置会与本地 Claude/Copilot/Codex 等编辑器的配置进行同步，确保全局与项目级配置的一致性。
    • 安全与扩展：网关支持多后端扩展、权限与安全策略，便于集成到企业级工作流中。

  • 其他注意

    • 本仓库的 MCP 网关与服务器实现属于一个完整的 MCP 服务端框架，具备核心功能的实现与整合测试，适合作为后端上下文服务的基础设施。
    • 若要将网关作为独立服务对外暴露，请遵循本仓库的端口配置与传输协议设计，确保前端客户端的兼容性。

服务器信息

访问项目