hyper-mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

Rust ホスト + WASM プラグインアーキテクチャ — 構造上メモリセーフです
プラグインが署名付き OCI アーティファクトとして配布されます（ghcr.io, Docker Hub）
実行時にプラグインを動的にロード/アンロードでき、再起動不要です
きめ細かい権限付与（ネットワーク、ファイルシステム、メモリ）

ライブデモ

実際の動作

hyper.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hyper": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "hyper",
      "command": "TODO",
      "args": [
        "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "hyper": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/hyper-mcp-rs/hyper-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add hyper -- TODO 'See README: https://github.com/hyper-mcp-rs/hyper-mcp'

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： hyper-mcp

hyper-mcp でインターナル MCP ツールを安全にデプロイする方法

👤 インターナルエージェントツールを構築するプラットフォームチーム ⏱ ~45 min advanced

使うタイミング： エンジニアに厳選されたツールセットを提供する必要があり、彼らが個々の npm MCP パッケージを検証することに信頼できない場合です。

前提条件

hyper-mcp バイナリがインストールされている — github.com/hyper-mcp-rs/hyper-mcp/releases からリリースをダウンロードしてください
プラグインをホストする OCI レジストリ — GHCR またはプライベート Harbor/ECR

フロー

署名付きプラグインをパブリッシュする

WASM プラグインを ./my-plugin.wasm に構築しました。ghcr.io/acme/my-plugin:v1 にプッシュして、sigstore で署名してください。✓ コピーしました

→ プラグインがレジストリで署名付きで利用可能です
hyper-mcp を設定してプルと検証を行う

~/.config/hyper-mcp/config.json を編集して、必要な署名者アイデンティティ付きのプラグイン URL を追加してください。✓ コピーしました

→ 再起動後、プラグインが hyper_mcp-list_plugins に表示されます
Claude からツールを呼び出す

my-plugin によって公開されたツールを使用して <X> を実行してください。✓ コピーしました

→ ツールはサンドボックス内で実行され、付与された権限を超える試みは拒否されます

結果： すべてのプラグインが署名され、バージョン管理され、サンドボックス化されたロックダウンされたインターナルツールセット。

注意点

デフォルトですべてのプラグインにネットワークアクセスを許可する — プラグインごとに allowed_hosts を設定します。デフォルトで拒否してください。
間違ったアイデンティティで署名されたプラグイン — hyper-mcp は拒否します。sigstore/rekor ログで署名者の不一致を確認してください

クライアントを再起動せずに hyper-mcp でエージェントツールをホットスワップする

👤 ツール API を反復するエージェント開発者 ⏱ ~10 min intermediate

使うタイミング： ツールをテストしており、30 秒ごとに MCP セッションをキルしない形で反復したい場合です。

フロー

新しいバージョンをロードする

my-plugin:v2 の URL で hyper_mcp-load_plugin を呼び出します。ロードされたことを確認してください。✓ コピーしました

→ プラグイン v2 が list_plugins に表示されます
必要に応じて古いバージョンをアンロードする

my-plugin:v1 で hyper_mcp-unload_plugin を呼び出してください。✓ コピーしました

→ v2 だけが残ります

結果： プラグイン開発のための密結合した内部ループ。

組み合わせ

他のMCPと組み合わせて10倍の力を

hyper + claude-code

Claude Code 内で hyper-mcp を唯一の MCP ホストとして実行し、すべてのカスタムツールをそれ経由でルーティングします

5 つの npx ベースの MCP を、内部プラグインレジストリを指す hyper-mcp に置き換えてください。✓ コピーしました

hyper + mcptools

Claude に表示される前にプラグインツールサーフェスをデバッグします

mcp ツールを使用して、hyper-mcp が現在広告しているものを列挙してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
hyper_mcp-list_plugins		ロードされているものを検査します。不足しているツールをデバッグしてください	0
hyper_mcp-load_plugin	url: str (oci://...), name?: str	実行時にプラグインを追加します	OCI プル 1 回
hyper_mcp-unload_plugin	name: str	プラグインを削除します。メモリを解放し、そのツールを無効にしてください	0

コストと制限

運用コスト

APIクォータ: なし — ローカルホスト
呼び出しあたりのトークン: プラグインによる — 通常 100–1000
金額: 無料。プライベートの場合、OCI レジストリホスティングにコストがかかる場合があります。
ヒント: 多くの npm ベースの MCP を実行する代わりに、複数のクライアント間で単一の hyper-mcp ホストを共有してください

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： プラグインシークレットは設定経由で挿入されます。OCI レジストリの認証情報は標準の docker/ghcr ログイン経由です

データ送信先： 各プラグインの allowed_hosts にリストされているホストへのみ

絶対に付与しない： 無制限のファイルシステム 無制限のネットワーク

トラブルシューティング

よくあるエラーと対処法

プラグイン署名検証エラー

sigstore 署名者アイデンティティが設定と一致することを確認します。正しいアイデンティティで cosign sign を使用して再署名してください

確認： cosign verify <oci-url>

プラグインはロードされるが、Claude にツールが表示されない

Claude はセッション開始時にツールリストをキャッシュします。ロード後に MCP クライアントを再起動してください

確認： hyper_mcp-list_plugins がプラグインと広告されたツールを表示する

WASM 実行トラップ/パニック

プラグインがリソース制限を超過したか、アンセーフ操作に遭遇しました。ログを確認します。信頼できる場合のみ設定で制限を上げてください

代替案

hyper-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
Arcade	WASM プラグインの代わりに Python フレームワークを使用したい	分離が少ない。サンドボックス化された WASM の代わりに Python ランタイム
Golf	Python ファースト、ツールファイルの自動検出	プラグイン分離されていない。すべてのツールが 1 つのプロセスで実行される
FastMCP	シンプルな Python MCP、レジストリ/サンドボックスは不要	配布戦略がない。変更のたびにサーバー全体を再配置する

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る