适合谁
- 使用 AI 编码助手并连接多个 MCP 服务器的开发人员
- 希望提高 AI 工具选择准确性的团队
- 希望组织工具集以匹配工作流程的用户
H
43FMRS · D
HyperTool MCP 通过动态工具集解决了 AI 工具管理的常见问题，提高了工具选择准确性。其 Persona 功能加速了设置过程。上下文测量功能很有用，但应视为近似值。
HyperTool MCP 是一个 MCP 服务器，它动态地从代理的 MCP 服务器中暴露工具，基于 Agent Persona 进行选择。它允许 AI 客户端连接无限数量的 MCP 服务器，并将其工具组织成聚焦的工具集（类似播放列表），从而突破工具数量限制，提高工具选择准确性。它支持预配置的 Persona（如 web-dev、data-scientist）以及上下文测量来估算每个工具的 token 使用量。
工具能力
list-available-tools
列出所有可用工具及其 token 估算值。
get-active-toolset
显示当前工具集及其 token 使用情况。
安装接入
- 将现有的 .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"
]
}
}
}
选型与风险
不适合谁
- 只需要一个或两个 MCP 服务器且工具数量少的用户
- 不需要复杂工具管理的 AI 应用
所需权限
- 读取和写入本地配置（~/.toolprint/hypertool-mcp/）以存储工具集和偏好设置
- 启动和管理子进程以代理 MCP 服务器
- 通过 stdio 与 MCP 客户端通信
风险与副作用
- 代理的 MCP 服务器可能具有与其工具相关的权限，例如文件系统访问或远程 API 调用。用户应审查这些服务器授予的权限。
- 配置错误可能导致工具不可用。确保 .mcp.hypertool.json 格式正确并包含有效的服务器配置。
- 上下文测量使用 BPE 近似值，并非精确的 token 计数，因此优化决策可能并非精确。
常见排障
- 如果服务器未启动，请检查 Node.js 版本是否 >= 18，并验证 .mcp.hypertool.json 的语法。
- 如果工具不显示，请确保工具集已创建并激活（使用 --equip-toolset）。
- 查看配置文件的存储位置，确保 HyperTool 运行时未在外部编辑。
- 如果代理服务器宕机，HyperTool 会自动重连，但可能需要检查服务器健康状态。
使用场景
当需要从多个 MCP 服务器使用超过 100 个工具时，避免工具数量限制
为特定任务（如开发、写作、调试）创建聚焦的工具集
使用预配置的 Persona 快速启动，如 web-dev 或 data-scientist
测量每个工具消耗的上下文，以优化工具集
支持客户端
Claude Desktop完整支持
Cursor完整支持
Claude Code部分支持