hyper-mcp

hyper-mcp

WebAssembly プラグインによって機能を拡張する、高速で安全な MCP サーバーです。

これは何ですか？

hyper-mcp を使うと、アプリケーションに AI 機能を簡単に追加できます。Claude Desktop、Cursor IDE、その他の MCP 対応アプリで動作します。お好みの言語でプラグインを作成し、コンテナレジストリを通じて配布して、クラウドからエッジまで、どこでも実行できます。

機能

• WebAssembly にコンパイルできる任意の言語でプラグインを作成
• 標準の OCI レジストリ（Docker Hub など）を通じてプラグインを配布
• Extism を基盤とし、堅牢なプラグインサポートを実現
• WASM によるサンドボックス化：ネットワーク、ファイルシステム、メモリへのアクセスを制限可能
• リソースが限られた環境でも使える軽量設計
• 仕様にある 3 つのプロトコルすべてに対応：stdio、sse、streamble-http。
• サーバーレス、エッジ、モバイル、IoT デバイスなど、あらゆる環境にデプロイ可能
• すぐに使えるクロスプラットフォーム互換性
• ツール名の衝突を防ぐためのツール名プレフィックスに対応

セキュリティ

セキュリティを最優先に設計されています。

• 許可なくシステムにアクセスできない、サンドボックス化されたプラグイン
• リソース制限によるメモリ安全な実行
• コンテナレジストリを通じた安全なプラグイン配布
• ホスト関数に対するきめ細かなアクセス制御
• OCI プラグインイメージは公開時に署名され、読み込み時に sigstore で検証されます。

はじめに

1. 設定ファイルを作成します。
   • Linux：$HOME/.config/hyper-mcp/config.json
   • Windows：{FOLDERID_RoamingAppData}。例：C:\Users\Alice\AppData\Roaming
   • macOS：$HOME/Library/Application Support/hyper-mcp/config.json

{
  "plugins": {
    "time": {
      "url": "oci://ghcr.io/tuananh/time-plugin:latest"
    },
    "qr_code": {
      "url": "oci://ghcr.io/tuananh/qrcode-plugin:latest"
    },
    "hash": {
      "url": "oci://ghcr.io/tuananh/hash-plugin:latest"
    },
    "myip": {
      "url": "oci://ghcr.io/tuananh/myip-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["1.1.1.1"]
      }
    },
    "fetch": {
      "url": "oci://ghcr.io/tuananh/fetch-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["*"],
        "memory_limit": "100 MB",
      }
    }
  }
}

📖 認証の設定、ランタイム設定、高度な機能など、設定オプションの詳細については、RUNTIME_CONFIG.md をご覧ください。

対応する URL スキーム：

• oci:// - OCI 準拠レジストリ用（Docker Hub、GitHub Container Registry など）
• file:// - ローカルファイル用
• http:// または https:// - リモートファイル用
• s3:// - Amazon S3 オブジェクト用（環境に AWS 認証情報を設定しておく必要があります）

2. サーバーを起動します。

$ hyper-mcp

• デフォルトでは stdio トランスポートを使用します。SSE を使う場合はフラグ --transport sse を、ストリーム可能な HTTP を使う場合は --transport streamable-http を指定します。
• デバッグする場合は RUST_LOG=info を使用します。
• 署名されていない OCI プラグインを読み込む場合は、insecure_skip_signature フラグまたは環境変数 HYPER_MCP_INSECURE_SKIP_SIGNATURE を true に設定する必要があります。

Cursor IDE での使用

hyper-mcp は、すべてのプロジェクトに対してグローバルに設定することも、個別のプロジェクトに対して設定することもできます。

1. プロジェクト単位で設定するには、プロジェクトのルートに .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "hyper-mcp": {
      "command": "/path/to/hyper-mcp"
    }
  }
}

2. Cursor の設定で hyper-mcp をセットアップします。

3. チャットからツールを使い始めます。

利用可能なプラグイン

すぐに使い始められるよう、いくつかのサンプルプラグインを用意しています。

V1 プラグイン

これらのプラグインは v1 プラグインインターフェースを使用します。引き続きサポートされていますが、新しいプラグインでは v2 インターフェースを使用してください。

• time：現在時刻の取得と時刻計算（Rust）
• qr_code：QR コードの生成（Rust）
• hash：さまざまな種類のハッシュの生成（Rust）
• myip：現在の IP の取得（Rust）
• fetch：基本的なウェブページの取得（Rust）
• crypto_price：暗号資産価格の取得（Go）
• fs：ファイルシステム操作（Rust）
• github：GitHub プラグイン（Go）
• eval_py：RustPython を使用した Python コードの評価（Rust）
• arxiv：arXiv 論文の検索とダウンロード（Rust）
• memory：SQLite を利用したメモリの保存と取得（Rust）
• sqlite：SQLite とのやり取り（Rust）
• crates-io：crate の一般情報と最新バージョンの確認（Rust）
• gomodule：Go モジュールの情報とバージョンの取得（Rust）
• qdrant：Qdrant ベクトル検索エンジンへのメモリの保存と取得（Rust）
• gitlab：GitLab プラグイン（Rust）
• meme_generator：ミームの生成（Rust）
• context7：ライブラリドキュメントの検索（Rust）
• think：思考ツール（Rust）
• maven：Maven プラグイン（Rust）
• serper：Serper ウェブ検索プラグイン（Rust）

V2 プラグイン

これらのプラグインは v2 プラグインインターフェースを使用します。新しいプラグインではこのインターフェースを使用してください。

• rstime：現在時刻の取得と時刻計算（Rust）

コミュニティ製プラグイン

• hackernews：このプラグインは Hacker News API に接続し、現在のトップ記事を取得して、タイトル、スコア、著者、URL とともに表示します。
• release-monitor-id：このプラグインは release-monitoring.org からプロジェクト ID を取得します。リリース済みソフトウェアのバージョン追跡に役立ちます。
• yahoo-finance：このプラグインは Yahoo Finance API に接続し、企業名またはティッカーシンボルに基づいて株価（OHLCV）を提供します。
• rand16：このプラグインはランダムな 16 バイトのバッファーを生成し、base64uri 形式で提供します。オンラインでの対称暗号化に非常に便利です。

ドキュメント

• ランタイム設定ガイド - 次の項目を含む、設定オプションの包括的なガイドです。
  • 認証の設定（Basic、Token、Keyring）
  • プラグインのランタイム設定
  • セキュリティに関する考慮事項とベストプラクティス
  • macOS、Linux、Windows 向けのプラットフォーム別 Keyring の設定
  • 認証に関する問題のトラブルシューティング
• ツールのスキップパターンガイド - 正規表現パターンを使用したツールのフィルタリングに関する包括的なガイドです。
  • パターンの構文と例
  • よくあるユースケースとベストプラクティス
  • 環境に応じたフィルタリング戦略
  • 高度な正規表現のテクニック
  • 移行とトラブルシューティング

プラグインの作成

プラグインの作成方法について詳しくは、CREATING_PLUGINS.md を参照してください。

ライセンス

Apache 2.0

スター履歴