tool-cli MCP Toolchain & Server Proxy

关键词

Model Context Protocol工具代理工具打包扫描与检测注册与加载

使用说明（Markdown 格式）

  • 项目简介

    • tool-cli 是一个用于 MCP（Model Context Protocol）生态的开发工具链，提供从代码生成、检测、打包到运行与托管 MCP 服务端工具的完整能力。核心组件包括一个 MCP 代理服务器实现、MCPB/Manifest 的支持、检测与打包工具、以及与注册中心交互的能力。

  • 主要功能点

    • MCP 服务器代理
      • 将前端客户端的 MCP 请求转发并聚合到后端 MCP 服务器，支持多种传输方式（stdio、HTTP）及会话管理。
    • 资源、工具、提示等的管理与渲染
      • 提供读取、执行工具方法、获取提示以及资源等能力的实现路径，便于后端与前端协同工作。
    • MCPB/Manifest 与模板能力
      • 支持根据已存在的服务器或检测结果生成 MCPB/Manifest 配置，包含服务器类型、传输、入口点、平台覆盖等字段，以及自动化的打包与发布流程。
    • 自动化检测与可直接生成对应代码/配置的能力
      • 针对 Node、Python、Rust 等环境提供检测实现与自动生成 scaffolding 的能力，帮助快速搭建 MCP 服务端框架。
    • 多平台打包与部署
      • 支持针对不同平台打包（mcpb/mcpbx），并提供相应的资源管理与平台覆盖配置。
    • 注册与发布工具
      • 与工具注册中心互通，支持工具包的发布、版本管理和下载，以及从注册中心拉取远端工具的能力。
    • 安全与认证支持
      • 提供 OAuth 等鉴权流程支持，以及本地凭据存储的实现，确保对 MCP 服务的安全交互。
    • 解析与格式化输出
      • 提供标准化的 JSON 输出以及简洁输出格式，方便 LLM/自动化脚本消费。

  • 安装步骤（简要）

    • 安装前提：需要 Rust 工具链（Cargo）以及 Git。
    • 获取源码并编译：
      • 克隆仓库并进入目录
      • 运行 cargo build --release
    • 运行 CLI（示例）：
      • 运行 tool-init 或直接执行已构建的可执行文件，详细命令请查看仓库中的 README 与命令帮助。
    • 说明
      • tool-cli 同时提供一个 CLI 二进制与若干库模块，核心能力包括 MCP 服务端代理、服务器模板生成、检测与打包等。

  • 服务器配置（示意性说明，JSON 配置要点，非代码注释）

    • server.name：服务器唯一标识名称，例如 "example-tool-server"
    • server.command：启动后端 MCP 服务器的执行命令，例如要运行的脚本或二进制名称（如 node、python 等）
    • server.args：启动命令的参数数组，包含入口点、端口、主机等需要的参数
    • server.transport：传输类型，stdio（本地进程）或 http（HTTP 服务）
    • server.mcp_config：执行配置，包含 command、args、env、url、headers、oauth_config 等字段，用于客户端与 MCP 服务器之间的通信参数
    • user_config：用于运行时的用户级配置信息，例如绑定地址 host
    • system_config：用于运行时的系统级信息，例如端口 port
    • 参考说明：MCP 客户端在连接 MCP 服务器时需要的最小信息通常包括服务器的启动命令及其参数，以及传输方式等。JSON 配置示例会明确列出 server.name、command、args、transport 等字段及解释，供 MCP 客户端在连接前配置与使用。

  • 基本使用方法

    • 启动与连接
      • 使用 tool-cli 配置并启动一个 MCP 服务器场景（本地或远程），然后将客户端指向该服务器以建立连接。
    • 流程概览
        1. 使用检测/生成工具创建或识别 MCPB/Manifest 配置
        1. 通过打包工具将服务器打包成 MCPB/mcpbx
        1. 启动服务端（stdio 传输）或对外暴露 HTTP 服务
        1. 客户端通过 MCP 协议与服务器进行工具调用、资源读取、获取 Prompts 等操作
    • 运行工具与代理
      • 通过 tool-cli 的 run 子命令或相应的代理服务入口来启动代理服务器：该代理将后端 MCP 服务器暴露给前端/LLM 客户端，让二者能够通过同一个 MCP 接入点进行通讯
    • 配置与扩展
      • 借助 tool-cli 的检测与 scaffold 能力快速创建新的 MCPB/Manifest，并通过 pack/publish 将工具包发布到 registry，供其他客户端发现与使用。

  • 运行示例要点

    • 代理服务器可以在本地启动，监听 3000 端口，通过 /mcp 路径与 MCP 客户端进行通信
    • 客户端需要的最小信息是服务器的启动命令和参数，以及传输协议（stdio / http），便于建立 MCP 连接
    • 支持从本地加载工具、或通过注册中心自动拉取远端工具并加载到本地环境

  • 关键词 Model Context Protocol, 工具代理, MCPB/Manifest 支持, 工具注册与打包, 脚手架与检测

  • 分类ID 1

服务器信息

访问项目