hypertool-mcp

すべてのMCPから、AIに最高のツールを提供しましょう 🎯

⚡ 特長

🔓 ツール数の制限から解放

MCP サーバーを無制限に接続できます。合計10個、50個、あるいは500個以上のツールを使っても、AIに表示されるのは必要なものだけです。

🎯 タスクに特化したツールセット

47個ものGitコマンドに圧倒される代わりに、5個のツールで「git-essentials」を作成できます。コンテキストはすぐに切り替えられます。

🧠 スマートなツールの説明

例やコンテキストを追加して、ツールの説明を充実させましょう。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では、ツールセットの管理を運用ツールから分離するスマートな設定モードを使用します。詳しくは設定モードガイドをご覧ください。

🎭 ペルソナ：設定済みツールバンドル（新機能！）

一から設定したくない場合は、ペルソナをお使いください。あらかじめ構築されたツールセットを備えた、すぐに使えるMCPサーバーバンドルです。

ペルソナとは？

ペルソナはAI向けの「アプリバンドル」のようなものです。以下が含まれています。

• ✅ 設定済みの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

利用可能なペルソナ

ペルソナ	含まれるサーバー	おすすめの用途
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	調査とナレッジワーク

ペルソナモードと標準モードの違い

# 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

💡 プロのヒント：ペルソナは既存のサーバーと組み合わせられます！--mcp-configを追加すると、ペルソナのサーバーにカスタムサーバーを加えられます。

📚 詳しくはこちら：詳しい手順、カスタムペルソナの作成方法、トラブルシューティングについては、ペルソナガイドをご覧ください。

📊 コンテキスト測定（新機能！）

各ツールが消費するコンテキスト量を正確に確認できます。すべてのツールのトークン推定値を参考に、ツールセットを最適化しましょう。

重要な理由：

• 🎯 コンテキスト使用量を最適化 - コンテキストウィンドウを大量に消費するツールを特定できます
• 📉 情報に基づいて判断 - ツールセットにツールを追加する前に、トークンコストを確認できます
• 🔍 代替ツールを比較 - 同じ処理を実行できる、より軽量なツールを見つけられます
• 💡 コンテキストの使用量を管理 - AI に公開する情報量を正確に把握できます

使い方：

これらの MCP ツールを使用してコンテキスト情報を確認するよう、AI に依頼します。

• 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 個制限を超えられます。	クイックスタート

❓ FAQ

一般的な質問

Q: MCP サーバーを直接使う場合と何が違いますか？ A: HyperTool を使うと、100 ツールの上限に達することなく、無制限の MCP サーバーを利用できます。また、AI のパフォーマンスを高めるために、用途を絞ったツールセットを動的に切り替えます。

Q: ペルソナと標準モードの違いは何ですか？ A: 標準モードでは、既存の MCP サーバー設定を使用します。ペルソナは、MCP サーバーと厳選されたツールセットの両方を含む、あらかじめパッケージ化されたセットです。すぐに使い始めたり、新しいワークフローを試したりするのに最適です。

Q: 複数のツールセットを同時に使用できますか？ A: stdio モード（デフォルト）では、起動時に --equip-toolset <name> を使用します。HTTP モードでは有効なツールセットは 1 つですが、いつでも切り替えられます。

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: いいえ！トークン数はキャッシュされ、追加されるオーバーヘッドは 10ms 未満です。パフォーマンスへの影響は感じられません。

技術的な質問

Q: 新しい MCP サーバーのツールを追加するにはどうすればよいですか？ A: .mcp.hypertool.json 設定ファイルにサーバーを追加するだけです。ツールセットで自動的に利用できるようになります。

Q: 本番環境で使用できますか？ A: はい！エンタープライズサポートについては、お問い合わせください。

🎮 アプリの互換性

MCP 互換アプリならどれでも動作します！ HyperTool は標準的な MCP サーバーなので、アプリが MCP に対応していれば、HyperTool にも対応しています。

再起動せずにツールセットをホットスワップ

アプリ	状態	ツールセットの切り替え方法
Cursor/VSCode	✅ 完全対応	ツールセットをすぐに切り替えられます。再起動は不要です！
Claude Code	⏳ 近日対応予定	--equip-toolset <name> フラグを使用してください（進捗を確認）
Claude Desktop	⏳ 対応中	ツールセットを切り替えた後、アプリを再起動してください

---

📚 詳細情報

• 🎭 ペルソナガイド - ペルソナの使用方法と作成方法を解説した完全ガイド
• 🔬 調査とパフォーマンス - 用途を絞ったツールセットが効果的な理由
• 🚀 高度な機能 - ツールの注釈、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

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

Service コマンド

hypertool-mcp service サブコマンドは現在無効になっており、実行すると通知を表示して終了します。

🤝 貢献

バグを見つけましたか？アイデアがありますか？ぜひご協力ください！

• 🐛 問題を報告
• 💡 アイデアを共有
• 🔧 PRを送信

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルをご覧ください。

---