Hypertool MCP

Give your AI the best tools from all your MCPs 🎯

](https://npmjs.com/package/@toolprint/hypertool-mcp) ](https://npmjs.com/package/@toolprint/hypertool-mcp)    

⚡ 特点/功能

解锁 摆脱工具限制

连接无限数量的MCP服务器。总共可使用10个、50个或500多个工具——您的AI只会看到它所需的内容。

🎯（目标） 任务专用工具集

使用5个工具构建“git-essentials”，无需淹没在47个Git命令中。即时切换上下文。

🧠 表示“大脑”或“思考”的意思。 智能工具描述

通过示例和上下文增强工具。你会发现你的AI选择正确工具的频率提高了89%。

🚀 快速入门

步骤1：复制您的现有配置

# In your project directory
cp .mcp.json .mcp.hypertool.json

步骤2：将您的AI指向HyperTool

替换你的 .mcp.json 与；带有；和……一起

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

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

重启你的AI并尝试：

You: "Create a toolset called 'coding' with git and docker tools"
AI: "Created 'coding' toolset with 15 focused tools"

You: "Switch to coding toolset"
AI: "Equipped! I now have just the tools needed for development"

就是这样！ 您的人工智能现在已专注且高效。 🎉（庆祝、欢呼的表情符号）

💡（灯泡图标，常用于表示灵感、想法或创意） 想要自动设置吗？ 尝试我们的互动式 setup 命令 - 查看 高级指南 详情请见。

📚 书籍或学习的象征 配置模式： HyperTool采用智能配置模式，将工具集管理与您的操作工具分开。欲了解更多信息，请参阅 配置模式指南。

🎭 人物：预配置工具包（新增！）

不想从头开始配置？使用角色模板——即开即用的MCP服务器包，内含预构建的工具集。

什么是用户角色（或人物设定）？

将“角色”视为你的人工智能的“应用包”——它们包含：

• ✅ 预配置的MCP服务器
• ✅ 为特定工作流程精选的工具集
• ✅ 您所需的一切，即刻开始使用

快速入门：使用角色设定

# 1. Clone the persona collection
git clone https://github.com/toolprint/awesome-mcp-personas

# 2. Add a persona (e.g., web-dev persona)
hypertool-mcp persona add awesome-mcp-personas/personas/web-dev

# 3. Run with the persona
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev

就是这么简单！无需服务器配置。该角色自带服务器和工具集。

📦 箱子/包裹 浏览所有可用的人格（或角色）： “awesome-mcp-personas” 可以翻译为“绝妙的MCP角色设定”或“超棒的MCP角色扮演”。这里，“awesome”表示“绝妙的”或“超棒的”，“mcp”可能指的是某种特定的上下文或领域中的缩写（如“多角色扮演”等，具体需根据上下文确定），“personas”意为“角色设定”或“角色扮演”

可用角色

“Persona vs Standard Mode” 可以翻译为“个性化模式与标准模式”

# Standard Mode (use your existing MCP servers):
npx -y @toolprint/hypertool-mcp mcp run --mcp-config .mcp.hypertool.json

# Persona Mode (bundled servers + pre-built toolsets):
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev

# Persona Mode with specific toolset:
npx -y @toolprint/hypertool-mcp mcp run --persona web-dev --equip-toolset frontend

💡 灵感/想法/创意（符号本身常用于表示这些概念） 专业提示“Personas”可以与您现有的服务器混合使用！添加 --mcp-config 将您的自定义服务器与角色的服务器一起包含进来。

📚 书籍 了解更多查看完整内容 《人物指南》 如需详细说明、创建自定义用户画像以及故障排除，请参阅以下内容。

📊 上下文测量（新增！）

查看每种工具实际消耗了多少上下文。通过为每种工具估算标记数来优化您的工具集。

Active toolset showing token usage per tool

为何这很重要：

• 🎯（靶心） 优化上下文使用 - 识别占用你上下文窗口的重量级工具
• 📉（股市下跌） 做出明智的决定 - 在向工具集添加工具之前，请查看代币成本
• 🔍 看起来像是一个放大镜的符号，通常用于表示搜索或查看细节。在中文中，可以简单地翻译为“🔍（放大镜）”或者根据上下文解释为“查看细节”、“搜索”等。如果直接作为一个符号使用，没有特定的中文对应词，但可以根据其功能进行描述。 比较备选方案 - 寻找能完成相同工作但更轻便的工具
• 💡 灯泡（表示想法或灵感的闪光） 为你的上下文制定预算 - 清楚地了解你正在向你的AI暴露什么信息

使用方法：

请你的AI使用这些MCP工具来查看上下文信息：

• list-available-tools - 显示所有可用工具的代币估算
• get-active-toolset - 显示当前装备的工具集中代币的使用情况

每个工具都会显示预估的标记数以及所占总上下文的百分比。非常适合构建简洁高效的工具集！

🎬 演示

跨100多种工具的热插拔工具集

_针对任意数量的MCP（机器学习平台/中间件/组件等，具体含义根据上下文确定）提供专门的工具集。通过工具调用切换到实现目标的最佳工具集。支持动态工具注册。_

🏗️ 工作原理

Before: Tool Chaos 😵
┌─────────────┐   ┌─────────────────────────────┐
│ Claude/     │──▶│ 50+ tools from 8 servers   │
│ Cursor      │   │ ❌ Wrong picks             │
│             │   │ ❌ Slow decisions          │
│             │   │ ❌ Confused context        │
└─────────────┘   └─────────────────────────────┘

After: Expert Mode 🎯
┌─────────────┐   ┌──────────────┐   ┌─────────────────┐
│ Claude/     │──▶│ HyperTool    │──▶│ ALL Your Tools  │
│ Cursor      │   │ (Local)      │   │ (Same servers)  │
└─────────────┘   └──────────────┘   └─────────────────┘
                         │
                         ▼
                  ┌─────────────────┐
                  │ Smart Toolsets  │
                  │ 🔨 coding (5)   │ ← "I'm coding now"
                  │ 📝 writing (3)  │ ← "I'm writing now"
                  │ 📊 analysis (4) │ ← "I'm analyzing now"
                  └─────────────────┘
                  ✅ Expert picks every time

什么是“工具集”？想象一下你的人工智能的播放列表

就像Spotify播放列表帮你整理音乐一样，工具集帮你整理人工智能工具：

ALL YOUR TOOLS (64 total)              YOUR TOOLSETS
┌────────────────────────────┐         ┌──────────────────┐
│ 🐳 Docker (19 tools)       │         │ 🔨 "coding"      │
│  • build_image             │   ┌───▶ │  • git.status    │
│  • create_container        │   │     │  • git.commit    │
│  • run_container           │   │     │  • docker.build  │
│  • stop_container          │   │     │  • docker.run    │
│  • [... 15 more]           │   │     │  • github.pr     │
├────────────────────────────┤   │     └──────────────────┘
│ 🔀 Git (12 tools)          │───┤
│  • status                  │   │     ┌──────────────────┐
│  • commit                  │   │     │ 📝 "writing"     │
│  • push                    │   └───▶ │  • notion.create │
│  • [... 9 more]            │         │  • slack.send    │
├────────────────────────────┤         │  • grammarly.fix │
│ 📝 Notion (8 tools)        │─────┐   └──────────────────┘
│ 💬 Slack (6 tools)         │     │
│ 📊 Linear (10 tools)       │     │   ┌──────────────────┐
│ 🧪 Testing (9 tools)       │     └─▶ │ 🐛 "debugging"   │
└────────────────────────────┘         │  • logs.search   │
                                       │  • docker.logs   │
AI sees ALL 64 tools = confused 😵     │  • traces.view   │
                                       └──────────────────┘

                                       AI sees 3-5 tools = focused 🎯

💼 实用工具集

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

🔨 开发模式

"deep-coding": git + docker + filesystem (12 tools)
→ Everything you need for feature development

"code-review": git + github + linear (10 tools)
→ Review PRs, update tickets, merge with confidence

"debugging": logs + docker + traces + alerts (8 tools)
→ Find and fix issues fast

📝 内容创作

"writing": notion + grammarly + slack (6 tools)
→ Blog posts, docs, and team updates

"research": perplexity + notion + filesystem (7 tools)
→ Deep dives with organized notes

🎬 实际聊天示例

You: "I need to debug our API"
AI: "I'll switch to the debugging toolset for better focus"
[Now has: logs, traces, curl, docker]

You: "Actually, let's write the incident report"
AI: "Switching to writing toolset"
[Now has: notion, slack, templates]

💡 灵感/想法/创意（光亮的灯泡形状，常用来表示灵感或创意的迸发） 专业提示每套工具先从3-5个开始。你的AI会感谢你的！

📋 所有功能

探索HyperTool的所有功能：

❓ 常见问题解答 (FAQ)

常见问题

问：这与直接使用MCP服务器有什么不同？ A: HyperTool让您能够使用无限数量的MCP服务器，而不会受到100个工具的限制，并且可以在不同的工具集之间动态切换，以提高AI性能。

问：Persona模式和标准模式有什么区别？ A：标准模式使用您现有的MCP服务器配置。Personas是预打包的组合包，其中既包含MCP服务器，也包含精选的工具集——非常适合快速上手或尝试新的工作流程。

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

问：我的工具集和配置存储在哪里？ A: 所有内容都本地存储在 ~/.toolprint/hypertool-mcp/：

• 人员： ~/.toolprint/hypertool-mcp/personas/
• 工具集： ~/.toolprint/hypertool-mcp/toolsets/
• 偏好设置： ~/.toolprint/hypertool-mcp/config/

当HyperTool未运行时，您可以直接编辑这些文件。

设置与兼容性

问：这个适用于Claude Desktop/Cursor/Claude Code吗？ A: 是的！Cursor 支持完全的热插拔。Claude Desktop 需要重启后才能工作。Claude Code 热插拔功能即将推出.

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

问：我可以与我的团队共享工具集吗？ A: 进口/出口功能即将推出！目前，您可以复制并共享工具集文件——如果您的团队配置了相同的MCP服务器，这些文件就可以正常工作。

问：上下文测量中的代币估计准确度如何？ A：这些估算采用了基于BPE（字节对编码）的近似方法，以便在工具之间进行一致的相对比较。它们非常适合用于理解哪些工具消耗了更多的上下文，但并不是精确的计数，因为不同的大型语言模型（LLM）使用不同的分词器。

问：上下文测量会减慢我的工具集速度吗？ A: 不是！标记计数被缓存了，增加的开销不到10毫秒。你不会注意到任何性能影响。

技术问题

问：如何从新的MCP服务器添加工具？ A: 只需将服务器添加到您的 .mcp.hypertool.json 配置。工具集会自动提供。

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

🎮 应用兼容性

与任何MCP兼容的应用程序均可配合使用！ HyperTool 是一个标准的 MCP 服务器，因此如果您的应用程序支持 MCP，那么它也支持 HyperTool。

无需重启的热插拔工具集

______________________________________________________________________

📚 书籍 了解更多

• 🎭 表情符号“🎭”的中文翻译可以是“戏剧面具”或“化妆表演”，它通常用来表示与戏剧、表演或化妆相关的主题。 人物指南 - 完整指南：使用和创建角色（或人物设定）
• 🔬 科学实验室或显微镜的符号（无具体文字含义，仅为符号） 研究与表现 - 为何专注型工具集有效
• 🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接保留原样用作表情，表示快速、前进或激动的情绪。所以，这个表情可以翻译为“🚀（火箭）”或者直接使用“🚀”来传达其含义。 高级功能 - 工具注释，HTTP模式，CLI（命令行界面）
• 🔧 修理工具或扳手的符号，常用于表示维修、修理或需要使用工具的情境。 故障排除 - 常见问题及解决方案
• 📖 代表书籍或阅读的符号，可翻译为“书”或“阅读”。在具体语境中，可根据需要选择更贴切的译文。 示例与配方 - 每个工作流的工具集模式

🛠️ 开发环境设置

先决条件

• Node.js 18及以上版本
• Python 3.8+（用于pre-commit钩子）

快速设置

# Clone and install
git clone https://github.com/toolprint/hypertool-mcp.git
cd hypertool-mcp
just setup-dev  # Installs dependencies and pre-commit hooks

预提交钩子（或提交前钩子）

这个项目使用预提交钩子来确保代码质量：

# Install pre-commit hooks (included in setup-dev)
just setup-pre-commit

# Run hooks manually
just pre-commit-check        # On staged files
just pre-commit-check-all    # On all files

# Skip hooks for emergency commits (use sparingly)
SKIP=eslint,typescript git commit -m "emergency fix"

可用命令

just build          # Build the project
just test           # Run tests
just lint           # Run linting
just format         # Format code
just typecheck      # Check types
just pre-publish-checks  # Run all quality checks

服务命令

该 hypertool-mcp service 子命令当前已禁用，将以（错误/异常等）退出 被调用时的通知。

🤝 贡献

发现了一个错误？有想法？我们非常希望得到你的帮助！

• 🐛 表示“虫子”或“错误（bug）”（在网络用语中常指软件或程序中的错误）。 报告问题
• 💡（这个符号通常表示“灯泡”，在中文里可以翻译为“💡”或者用文字描述为“灯泡符号”） 分享想法
• 🔧 修理工具/螺丝刀 提交拉取请求（Pull Requests）

📄 许可证

MIT 许可证 - 请参阅 许可证 文件中有详细信息。

______________________________________________________________________

由厌倦了看着AI选择错误工具的开发者们所打造 🎯（目标）

Built with ❤️ by Toolprint

© 2025 OneGrep, Inc.