超能工具-MCP

【技术文档摘要】

<picture> <source media="(prefers-color-scheme: dark)" srcset="./assets/hypertool_darkmode_wordmark_horizontal.png"> <source media="(prefers-color-scheme: light)" srcset="./assets/hypertool_lightmode_wordmark_horizontal.png"> <img alt="显示在浅色模式下的深色模式hypertool-mcp标志和在深色模式下的白色标志。" src="./assets/hypertool_lightmode_wordmark_horizontal.png" width="full"> </picture> <h1 align="center">为您的AI提供来自所有MCP的最佳工具 🎯</h1>

⚡ 特性

🔓 突破工具限制

连接无限数量的MCP服务器。使用10个、50个或500多个工具——您的AI只需看到它需要的。

🎯 任务特定工具集

构建“git-essentials”，仅包含5个工具，而不是淹没在47个Git命令中。即时切换上下文。

🧠 智能工具描述

通过示例和上下文增强工具。观察您的AI选择正确工具的频率提高89%。

🚀 快速开始

第一步：复制现有配置

# 在您的项目目录中
cp .mcp.json .mcp.hypertool.json

第二步：指向HyperTool

替换您的.mcp.json：

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

第三步：创建您的第一个工具集

重启您的AI并尝试：

您: "创建一个名为'coding'的工具集，包含git和docker工具"
AI: "已创建'coding'工具集，包含15个专注的工具"

您: "切换到coding工具集"
AI: "装备完毕！我现在只有开发所需的工具"

就这样！ 您的AI现在更加专注和有效。🎉

💡 想要自动设置？ 尝试我们的交互式setup命令——详情见高级指南。

📚 配置模式： HyperTool使用智能配置模式来分离工具集管理与操作工具。了解更多，请参阅配置模式指南。

🎭 角色：预配置工具包（新功能）

不想从头开始配置？使用角色——带有预建工具集的现成MCP服务器捆绑包。

什么是角色？

想象角色是您AI的“应用包”——它们包括：

• ✅ 预配置的MCP服务器
• ✅ 针对特定工作流程的精选工具集
• ✅ 立即启动所需的一切

使用角色快速开始

# 1. 克隆角色集合
git clone https://github.com/toolprint/awesome-mcp-personas

# 2. 添加一个角色（例如，web-dev角色）
hypertool-mcp persona add awesome-mcp-personas/personas/web-dev

# 3. 使用角色运行
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev

就这样！无需服务器配置。角色自带服务器和工具集。

📦 浏览所有可用的角色： awesome-mcp-personas

可用角色

角色	包含的服务器	最适合
web-dev	Git, Docker, 文件系统, 浏览器, 测试	全栈Web开发
data-scientist	Python, Jupyter, 数据库, 文件系统, 绘图	数据分析及ML工作流
devops	Docker, Kubernetes, AWS, Terraform, 监控	基础设施及部署
content-creator	Notion, Slack, 语法检查, SEO, 社交媒体	写作及内容管理
researcher	Perplexity, Arxiv, Wikipedia, 文件系统	研究及知识工作

角色与标准模式对比

# 标准模式（使用您现有的MCP服务器）：
npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json

# 角色模式（捆绑服务器+预建工具集）：
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev

# 角色模式与特定工具集：
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev --equip-toolset frontend

💡 小贴士： 角色可以与您现有的服务器混合使用！添加--mcp-config以在角色服务器旁边包含您的自定义服务器。

📚 了解更多： 查看完整的角色指南，获取详细说明、创建自定义角色以及故障排除。

📊 上下文测量（新功能）

确切地查看每个工具消耗多少上下文。使用每个工具的令牌估计值优化您的工具集。

<div align="center"> <img src="./assets/toolset_context.png" alt="工具集上下文视图" width="700"> <p><em>当前工具集显示每个工具的令牌使用情况</em></p> </div>

为什么重要：

• 🎯 优化上下文使用 - 识别消耗上下文窗口的重型工具
• 📉 做出明智决策 - 在将工具添加到工具集之前查看令牌成本
• 🔍 比较替代方案 - 找到执行相同任务的更轻量级工具
• 💡 预算您的上下文 - 了解您向AI暴露的确切内容

如何使用：

要求您的AI使用这些MCP工具以查看上下文信息：

• list-available-tools - 显示所有可用工具的令牌估计值
• get-active-toolset - 显示您当前装备的工具集的令牌使用情况

每个工具都显示了估计的令牌数和占总上下文的比例。非常适合构建精简高效的工具集！

🎬 演示

在100多个工具之间热交换工具集

在任意数量的MCP之间切换目标工具集。通过工具调用来切换最佳工具集。动态工具注册。

<div align="center"> <a href="https://www.youtube.com/watch?v=43fkKOBayCg"> <img src="./demos/build_dynamic_toolsets_1080p_25fps.gif" alt="HyperTool演示 - 单击观看完整视频" width="800"> </a> </div>

🏗️ 工作原理

之前：工具混乱 😵
┌─────────────┐   ┌─────────────────────────────┐
│ Claude/     │──▶│ 8个服务器的50+工具         │
│ Cursor      │   │ ❌ 错误的选择               │
│             │   │ ❌ 决策缓慢                 │
│             │   │ ❌ 上下文混淆               │
└─────────────┘   └─────────────────────────────┘

之后：专家模式 🎯
┌─────────────┐   ┌──────────────┐   ┌─────────────────┐
│ Claude/     │──▶│ HyperTool    │──▶│ 您的所有工具    │
│ Cursor      │   │ (本地)       │   │ (相同服务器)    │
└─────────────┘   └──────────────┘   └─────────────────┘
                         │
                         ▼
                  ┌─────────────────┐
                  │ 智能工具集      │
                  │ 🔨 编码 (5)    │ ← "我现在正在编码"
                  │ 📝 写作 (3)    │ ← "我现在正在写作"
                  │ 📊 分析 (4)    │ ← "我现在正在分析"
                  └─────────────────┘
                  ✅ 每次都是专家选择

什么是“工具集”？想象这是您AI的播放列表

就像Spotify播放列表组织您的音乐一样，工具集组织您的AI工具：

所有您的工具（总计64个）              您的工具集
┌────────────────────────────┐         ┌──────────────────┐
│ 🐳 Docker (19个工具)       │         │ 🔨 "coding"      │
│  • 构建镜像                │   ┌───▶ │  • git.status    │
│  • 创建容器                │   │     │  • git.commit    │
│  • 运行容器                │   │     │  • docker.build  │
│  • 停止容器                │   │     │  • docker.run    │
│  • [... 15个更多]          │   │     │  • github.pr     │
├────────────────────────────┤   │     └──────────────────┘
│ 🔀 Git (12个工具)          │───┤
│  • 状态                    │   │     ┌──────────────────┐
│  • 提交                    │   │     │ 📝 "writing"     │
│  • 推送                    │   │     │  • notion.create │
│  • [... 9个更多]           │         │  • slack.send    │
├────────────────────────────┤         │  • grammarly.fix │
│ 📝 Notion (8个工具)        │─────┐   └──────────────────┘
│ 💬 Slack (6个工具)         │     │
│ 📊 Linear (10个工具)       │     │   ┌──────────────────┐
│ 🧪 测试 (9个工具)          │     └─▶ │ 🐛 "调试"       │
└────────────────────────────┘         │  • 日志搜索       │
                                       │  • docker日志     │
AI看到全部64个工具 = 混乱 😵           │  • 跟踪视图       │
                                       └──────────────────┘

                                       AI看到3-5个工具 = 专注 🎯

💼 实际工具集

为不同的工作流程创建专注的工具集：

🔨 开发模式

"深度编码": git + docker + 文件系统 (12个工具)
→ 功能开发所需的一切

"代码审查": git + github + linear (10个工具)
→ 审查PR，更新票证，自信合并

"调试": 日志 + docker + 跟踪 + 报警 (8个工具)
→ 快速找到并修复问题

📝 内容创作

"写作": notion + grammarly + slack (6个工具)
→ 博客文章，文档，团队更新

"研究": perplexity + notion + 文件系统 (7个工具)
→ 深度挖掘并整理笔记

🎬 实际聊天示例

您: "我需要调试我们的API"
AI: "我将切换到调试工具集以获得更好的专注"
[现在有：日志，跟踪，curl，docker]

您: "实际上，让我们写一份事故报告"
AI: "切换到写作工具集"
[现在有：notion，slack，模板]

💡 小贴士： 每个工具集从3-5个工具开始。您的AI会感谢您！

📋 所有功能

探索HyperTool可以做的一切：

功能	描述	指南
🎭 角色	预配置的MCP服务器捆绑包，带有精选工具集。立即启动，适用于web-dev、数据科学、DevOps等现成的工作流程。	角色指南
📁 服务器组	将MCP服务器组织成逻辑组。一起启动相关服务器，切换项目，并保持专注的上下文。	高级指南
📊 上下文测量	查看每个工具的令牌估计值。通过理解每个工具消耗的上下文量来优化您的工具集。	上下文测量
🔧 配置模式	智能分离工具集管理和操作工具。让您的AI专注于工作，而不是配置。	配置模式指南
🎯 动态工具集	在线构建、修改和切换工具集。适应您的AI能力以匹配当前任务。	示例与配方
🧠 工具注释	通过自定义描述、示例和上下文增强工具。提高您的AI工具选择准确性89%。	高级指南
🚀 HTTP模式	作为持久连接和更快响应时间的长期HTTP服务器运行HyperTool。	高级指南
🔌 无限服务器	连接您需要的任何数量的MCP服务器。突破100个工具的限制而不牺牲性能。	快速开始

❓ 常见问题

一般问题

Q: 这与直接使用MCP服务器有何不同？ A: HyperTool让您使用无限数量的MCP服务器，而不会达到110个工具的限制，并且动态切换专注的工具集以提高AI性能。

Q: 角色和标准模式有什么区别？ A: 标准模式使用您现有的MCP服务器配置。角色是预打包的捆绑包，包括MCP服务器和精选工具集——非常适合快速启动或尝试新的工作流程。

Q: 我可以同时使用多个工具集吗？ A: 在stdio模式（默认）中，启动时使用--equip-toolset <name>。HTTP模式支持一个活动工具集，但您可以随时切换。

Q: 我的工具集和配置存储在哪里？ A: 一切都在本地存储于~/.toolprint/hypertool-mcp/：

• 角色：~/.toolprint/hypertool-mcp/personas/
• 工具集：~/.toolprint/hypertool-mcp/toolsets/
• 设置：~/.toolprint/hypertool-mcp/config/ 当HyperTool未运行时，您可以直接编辑这些文件。

设置与兼容性

Q: 这与Claude Desktop / Cursor / Claude Code兼容吗？ A: 是的！Cursor具有完全的热交换支持。Claude Desktop在重启后工作。Claude Code 即将支持热交换。

Q: 如果MCP服务器宕机怎么办？ A: HyperTool监控健康状况并在服务器恢复时自动重新连接。您的工具集保持完整。

Q: 我可以与我的团队共享工具集吗？ A: 导入/导出即将推出！目前，您可以复制并分享工具集文件——如果您的团队配置了相同的MCP服务器，它们将正常工作。

Q: 上下文测量中的令牌估计有多准确？ A: 估计使用基于BPE的近似值进行一致的相对比较。它们非常适合了解哪些工具消耗更多的上下文，但由于不同的LLM使用不同的分词器，因此不是精确计数。

Q: 上下文测量会减慢我的工具集吗？ A: 不会！令牌计数被缓存，增加不到10毫秒的开销。您不会注意到任何性能影响。

技术问题

Q: 如何从新的MCP服务器添加工具？ A: 只需将服务器添加到您的.mcp.hypertool.json配置中。它将自动可用于工具集。

Q: 我可以在生产环境中使用这个吗？ A: 可以！对于企业支持，请联系我们。

🎮 应用兼容性

与任何MCP兼容的应用程序兼容！ HyperTool是一个标准的MCP服务器，所以如果您的应用程序支持MCP，它也支持HyperTool。

无需重启即可热交换工具集

应用	状态	如何切换工具集
Cursor/VSCode	✅ 完全支持	立即切换工具集——无需重启！
Claude Code	⏳ 即将推出	使用--equip-toolset <name>标志（[跟踪进度