hypertool-mcp

为你的 AI 提供所有 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"

就这么简单！ 现在你的 AI 专注而高效。🎉

💡 想要自动设置？ 试试交互式 setup 命令——详情请参阅高级指南。

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

🎭 Personas：预配置的工具包（全新！）

不想从头开始配置？使用 personas——包含预构建工具集、可直接使用的 MCP 服务组合。

什么是 Personas？

你可以把 personas 想成是为 AI 准备的「应用套件」——其中包含：

• ✅ 预配置的 MCP 服务
• ✅ 针对特定工作流精心挑选的工具集
• ✅ 即刻上手所需的一切

使用 Personas 快速开始

# 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

就这么简单！无需配置服务。persona 自带服务和工具集。

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

可用 Personas

Persona	包含的服务	适用场景
web-dev	Git、Docker、Filesystem、Browser、Testing	全栈 Web 开发
data-scientist	Python、Jupyter、Database、Filesystem、Plotting	数据分析和 ML 工作流
devops	Docker、Kubernetes、AWS、Terraform、Monitoring	基础设施和部署
content-creator	Notion、Slack、Grammar、SEO、Social	写作和内容管理
researcher	Perplexity、Arxiv、Wikipedia、Filesystem	研究和知识工作

Persona 模式与标准模式

# 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，即可在 persona 的服务之外加入你的自定义服务。

📚 了解更多： 请参阅完整的 Personas 指南，了解详细说明、如何创建自定义 personas 以及故障排除。

📊 上下文用量测量（全新！）

精准查看每个工具消耗的上下文用量。通过每个工具的令牌估算，优化你的工具集。

重要性：

• 🎯 优化上下文用量 - 找出占用上下文窗口较多的重量级工具
• 📉 做出明智决策 - 将工具添加到工具集前，先查看令牌开销
• 🔍 比较替代方案 - 找出能够完成相同工作的轻量级工具
• 💡 规划上下文用量 - 准确了解你向 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

什么是“工具集”？把它想成 AI 的播放列表

就像 Spotify 播放列表整理音乐一样，工具集可以整理你的 AI 工具：

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 的全部功能：

功能	描述	指南
🎭 角色预设	预先配置的 MCP 服务组合，并附带精选工具集。使用适用于 Web 开发、数据科学、DevOps 等场景的现成工作流，即刻开始使用。	角色预设指南
📁 服务分组	将 MCP 服务整理到逻辑分组中。一起启动相关服务、在不同项目间切换，并保持专注的上下文。	高级指南
📊 上下文用量测量	查看每个工具的令牌估算。准确了解每个工具消耗多少上下文，从而优化工具集。	上下文用量测量
🔧 配置模式	智能区分工具集管理与操作工具。让 AI 专注于工作，而不是配置。	配置模式指南
🎯 动态工具集	即时构建、修改和切换工具集。根据当前任务调整 AI 的能力。	示例与配方
🧠 工具注释	为工具添加自定义说明、示例和上下文。将 AI 选择工具的准确率提高 89%。	高级指南
🚀 HTTP 模式	将 HyperTool 作为长时间运行的 HTTP 服务，以实现持久连接和更快的响应时间。	高级指南
🔌 服务数量不限	根据需要连接任意数量的 MCP 服务。突破 100 个工具的限制，同时不牺牲性能。	快速入门

❓ 常见问题

常见问题

问：这与直接使用 MCP 服务有什么区别？ 答：HyperTool 让你能够使用不限数量的 MCP 服务，而不会触及 100 个工具的上限，并且可以动态切换到专注的工具集，以提升 AI 性能。

问：Persona 和标准模式有什么区别？ 答：标准模式使用你现有的 MCP 服务配置。Persona 是预先打包的组合，同时包含 MCP 服务和精选工具集，非常适合快速上手或尝试新的工作流。

问：可以同时使用多个工具集吗？ 答：在 stdio 模式（默认）下，启动时使用 --equip-toolset <name>。HTTP 模式支持一个活动工具集，但你可以随时切换。

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

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

设置与兼容性

问：这适用于 Claude Desktop / Cursor / Claude Code 吗？ 答：是的！Cursor 完全支持热切换。Claude Desktop 需要重启。Claude Code 即将支持热切换。

问：如果 MCP 服务宕机了怎么办？ 答：HyperTool 会监控运行状况，并在服务恢复后自动重新连接。你的工具集会保持完整。

问：可以与团队共享工具集吗？ 答：导入/导出功能即将推出！目前，你可以复制并共享工具集文件——只要团队配置了相同的 MCP 服务，这些文件就能正常使用。

问：上下文测量中的 Token 估算有多准确？ 答：估算使用基于 BPE 的近似值，以便一致地比较不同工具。它们非常适合了解哪些工具消耗更多上下文，但并非精确计数，因为不同的大模型使用不同的分词器。

问：上下文测量会降低工具集的速度吗？ 答：不会！Token 数量会缓存，额外开销不到 10 毫秒。你不会察觉到任何性能影响。

技术问题

问：如何从新的 MCP 服务添加工具？ 答：只需将服务添加到 .mcp.hypertool.json 配置中，即可自动用于工具集。

问：可以在生产环境中使用吗？ 答：可以！如需企业支持，联系我们。

🎮 应用兼容性

适用于任何兼容 MCP 的应用！ HyperTool 是标准的 MCP 服务，因此只要你的应用支持 MCP，就支持 HyperTool。

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

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

---

📚 了解更多

• 🎭 Persona 指南 - Persona 的使用与创建完整指南
• 🔬 研究与性能 - 专注的工具集为何有效
• 🚀 高级功能 - 工具注释、HTTP 模式、命令行
• 🔧 故障排除 - 常见问题与解决方案
• 📖 示例与配方 - 适用于各种工作流的工具集模式

🛠️ 开发环境设置

前置条件

• 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

Pre-commit 钩子

本项目使用 pre-commit 钩子来确保代码质量：

# 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 子命令已禁用，调用时会退出并显示通知。

🤝 参与贡献

发现了错误？有新想法？欢迎帮助我们！

• 🐛 报告问题
• 💡 分享想法
• 🔧 提交 PR

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件。

---