← 返回目录

HyperTool MCP

社区

网关 / 代理

给你的 AI 配备来自所有 MCP 的最佳工具 🎯

这是聚合或代理其他 MCP Server 的网关，需要再接入具体的 Server 才有实际能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 327 / 438
Stars: ★ 155 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 12 个月前 ⚠
工具数: 2

43FMRS · D

HyperTool MCP 通过动态工具集解决了 AI 工具管理的常见问题，提高了工具选择准确性。其 Persona 功能加速了设置过程。上下文测量功能很有用，但应视为近似值。

最强项 · 文档质量 11/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

8/20

维护活跃度

8/20

文档质量

11/20

安装易用性

10/20

查看各项评分依据

可靠性 6/20: 源代码仅提供了 README 和 manifest，缺少实际代码、测试和 CI 验证。虽然 README 描述了动态工具注册和工具集切换等功能，但没有可执行的证据证明这些特性确实按描述工作。因此，可靠性评分较低，因为关键路径未被验证，错误处理情况不明。
安全与权限 8/20: README 中未发现明显的恶意代码证据。服务器确实需要代理多个 MCP 服务器并动态暴露工具，这涉及管理多个服务器的凭证，但 README 未说明凭证存储方式或最小权限原则。未发现不可逆操作默认执行的证据。但由于缺少源代码审查，无法确认安全实现细节，因此得分保守。
维护活跃度 8/20: 仓库有 155 颗星和 9 个未关闭 issue，但未提供提交频率、发布历史和 issue 响应速度的数据。许可证标记为 'NOASSERTION'，这令人担忧。尽管 README 显示活跃开发（版本 0.0.42），但缺乏许可证和版本管理细节降低了评分。
文档质量 11/20: README 文档非常详尽，包含快速入门、功能列表、常见问题解答和截图。提供了多种场景的配置示例。但缺少关于高级配置、故障排除和限制的深入文档。部分指南链接可能未提供（如 ADVANCED.md 等）。由于没有源代码验证，文档中描述的功能可能不准确。
安装易用性 10/20: README 提供了清晰的安装步骤，包括复制配置、修改 JSON 和使用 npx 命令。示例配置直接可用。但缺少自动配置工具的详细说明，且平台兼容性未明确。由于没有实际测试，安装步骤可能因环境而失败。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

使用 AI 编码助手并连接多个 MCP 服务器的开发人员
希望提高 AI 工具选择准确性的团队
希望组织工具集以匹配工作流程的用户

不适合谁

只需要一个或两个 MCP 服务器且工具数量少的用户
不需要复杂工具管理的 AI 应用

所需权限

读取和写入本地配置（~/.toolprint/hypertool-mcp/）以存储工具集和偏好设置
启动和管理子进程以代理 MCP 服务器
通过 stdio 与 MCP 客户端通信

风险与副作用

代理的 MCP 服务器可能具有与其工具相关的权限，例如文件系统访问或远程 API 调用。用户应审查这些服务器授予的权限。
配置错误可能导致工具不可用。确保 .mcp.hypertool.json 格式正确并包含有效的服务器配置。
上下文测量使用 BPE 近似值，并非精确的 token 计数，因此优化决策可能并非精确。

安装接入

准备工作

运行环境：Node.js 18+

将现有的 .mcp.json 复制为 .mcp.hypertool.json
用 HyperTool 配置替换 .mcp.json，如上所示
重启 AI 客户端
使用交互式命令创建工具集，例如：“创建一个名为 coding 的工具集，包含 git 和 docker 工具”

claude_desktop_config.json

{
  "mcpServers": {
    "hypertool": {
      "command": "npx",
      "args": [
        "-y",
        "@toolprint/hypertool-mcp",
        "mcp",
        "run",
        "--mcp-config",
        ".mcp.hypertool.json"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "hypertool": {
      "command": "npx",
      "args": [
        "-y",
        "@toolprint/hypertool-mcp",
        "mcp",
        "run",
        "--mcp-config",
        ".mcp.hypertool.json"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add hypertool -- npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置中添加 hypertool 服务器并重启后，向 AI 询问 'list-available-tools'，若能看到已配置 MCP 服务器的工具及其 token 估算，说明代理连接成功。

常见排障

如果服务器未启动，请检查 Node.js 版本是否 >= 18，并验证 .mcp.hypertool.json 的语法。
如果工具不显示，请确保工具集已创建并激活（使用 --equip-toolset）。
查看配置文件的存储位置，确保 HyperTool 运行时未在外部编辑。
如果代理服务器宕机，HyperTool 会自动重连，但可能需要检查服务器健康状态。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个名为 'coding' 的工具集，包含 git 和 docker 工具
切换到 coding 工具集
使用 list-available-tools 查看每个工具的 token 估算
用 get-active-toolset 显示当前工具集的上下文占用

工具能力 2

list-available-tools 只读

列出所有可用工具及其 token 估算值。

get-active-toolset 只读

显示当前工具集及其 token 使用情况。

使用场景

当需要从多个 MCP 服务器使用超过 100 个工具时，避免工具数量限制

为特定任务（如开发、写作、调试）创建聚焦的工具集

使用预配置的 Persona 快速启动，如 web-dev 或 data-scientist

测量每个工具消耗的上下文，以优化工具集

支持客户端

Claude Desktop

Cursor

Claude Code部分支持

依据项目文档列出，未经本站实测。

详细介绍

HyperTool MCP 是一个 MCP 服务器，它动态地从代理的 MCP 服务器中暴露工具，基于 Agent Persona 进行选择。它允许 AI 客户端连接无限数量的 MCP 服务器，并将其工具组织成聚焦的工具集（类似播放列表），从而突破工具数量限制，提高工具选择准确性。它支持预配置的 Persona（如 web-dev、data-scientist）以及上下文测量来估算每个工具的 token 使用量。