Hyperterse

Hyperterseとは？

Hyperterseは、宣言的設定からMCP（Model Context Protocol）ツールサーバを構築するオープンソースフレームワークです。多数の個別MCPツールエンドポイントを公開する代わりに、ツール定義を標準準拠のMCPサーバにコンパイルし、エージェントが一貫したインターフェースで利用できるようにします。

フレームワークの主な目的は、「ツールを一度定義する」（データベース接続や認証ルールを含む）だけで、Hyperterseがランタイムの懸念事項—認証施行、結果キャッシュ、観測可能性—を処理し、各ツールエンドポイントごとにグルーコードを書いたりメンテナンスしたりする必要がないことです。

主な機能

• ディレクトリと宣言ファイルからの宣言的ツール定義：app/tools/以下の各ディレクトリが自動的にツールになり、各ツールごとに登録コードを書く必要がありません。
• 2ツールMCPインターフェース（search + execute）：エージェントはsearchとexecuteの正確に2つのMCPツールのみを公開するサーバとやり取りし、Hyperterseが動的に正しい基底ツール実装を発見・ルーティングします。
• api_keyプラグインによる認証内蔵：ビルトインのapi_keyプラグイン（または独自実装）でツールに認証を付与し、各execute呼び出し前に自動的に認証が施行されます。
• グローバルまたはツールごとのTTLによるキャッシュ：同一execute呼び出しでキャッシュ結果を返却しデータベースを叩かないよう結果キャッシュを有効化；キャッシュルールはグローバルまたはツールごとに設定可能です。
• マネージドプーリングとライフサイクル付きマルチデータベース対応：アダプタでPostgreSQL、MySQL、MongoDB、Redisに接続；Hyperterseが接続プーリング、健康チェック、優雅なシャットダウンを管理します。
• OpenTelemetryによる観測可能性：HyperterseにOpenTelemetryトレース、メトリクス、構造化ログが含まれており、searchとexecute呼び出しのエンドツーエンドをデバッグできます。
• ハンドラーと変換用のTypeScriptスクリプト：宣言ファイルだけでは不十分な場合、fetchとconsole付きサンドボックスランタイムで動作するスクリプトとしてハンドラー/変換を追加します。
• 単一アーティファクトへのコンパイル＆デプロイ：宣言ファイルとスクリプトをDocker、Kubernetes、ベアメタル、任意のクラウド環境でサーブ可能な1つのアーティファクトにコンパイルします。

Hyperterseの使い方

1. Hyperterseをインストール：提供コマンド（cURL、NPM、Bun、Homebrew）のいずれかを使用。
2. ツールとアダプタ定義を作成：
   • データベースアダプタをapp/adapters/に配置。
   • ツール宣言をapp/tools/に配置；各ツールはディレクトリ名で表され、SQL文、型付き入力、オプションの認証・キャッシュルールを含む宣言ファイルを含みます。
3. （オプション）宣言ファイルを超えるロジックが必要な場合にTypeScriptハンドラー/変換を追加。
4. サーバアーティファクトをビルド/コンパイルし、ツール、スクリプト、設定をバンドル。
5. コンパイル済MCPサーバを対象環境でサーブ；エージェントはsearchでツールを探し、executeで構造化入力付きで選択ツールを実行。

ユースケース

• データベースベースの調査・分析ツール：app/tools/に多数のSQLベースツールを定義し、エージェントがsearchで適切なクエリツールを見つけ、executeで型付き入力付きで実行。
• マルチテナントまたはアクセス制御付きツール実行：特定ツールにAPIキー認証ルールを付与し、各execute呼び出し前に自動認証。
• コスト・レイテンシ感度の高いクエリワークフロー：TTL付きグローバル/ツールごとキャッシュを有効化し、繰り返しexecuteでキャッシュ結果を返却してデータベース再クエリを回避。
• MCPサーバ動作を標準化するチーム：ビルトイン認証、キャッシュ、OpenTelemetryトレースでツールサーバを一貫させ、各ツールエンドポイントごとに別ボイラープレートをメンテ不要。
• インフラ横断のプロダクションデプロイ：単一アーティファクトにコンパイルし、Docker、Kubernetes、ベアメタル、クラウド環境にツール定義変更なしでデプロイ。

FAQ

• Hyperterseは何のために作られていますか？ Hyperterseは宣言ファイルからMCPツールサーバを構築するためのフレームワークで、認証・キャッシュ・オブザーバビリティのサポートを内蔵してコンパイル・提供します。

• Hyperterseは無料で使えますか？ はい。Apache 2.0ライセンスの下で無料・オープンソースで、セルフホスト可能です。

• 宣言ファイルはどのようにツールにマッピングされますか？ ツールはapp/tools/の下で定義されます。各ツールディレクトリがツール名に対応し、ディレクトリの宣言ファイルがSQL文、型付き入力、オプションの認証/キャッシュルールを指定します。

• どのデータベースがサポートされていますか？ HyperterseはPostgreSQL、MySQL、MongoDB、Redisをボックス外でサポートし、専用アダプタを使用します。

• HyperterseはエージェントにどのMCPインターフェースを公開しますか？ Hyperterseはツール定義の数に関係なく、正確に2つのMCPツール—searchとexecute—を公開します。

代替案

• 明示的なエンドポイントを持つカスタムMCPツールサーバ: 機能ごとに1つのツールエンドポイントを公開するMCPサーバを構築。細かな制御が可能ですが、通常は登録・検証・認証・キャッシュ・オブザーバビリティのコードを多く書く・維持する必要があります。
• コンパイルではなくルーティング/ディスカバリに焦点を当てるフレームワーク: エージェントやルーターがリクエストをバックエンド関数/ツールにマッピングするアプローチを使用。Hyperterseに比べ、検証・認証・キャッシュ・トレーシングを一貫して実装する必要があります。
• アプリケーション管理ミドルウェア付きのデータベース専用ツールライブラリ: 型付きデータベースアクセスライブラリを使用し、認証・キャッシュ・トレーシングのミドルウェアをアプリ層で実装。MCPフレームワークの責任を移し、ツールごとの統合作業が増えます。
• ツール実行のための汎用ワークフローエンジン: 設定に基づいてタスクを実行するオーケストレータ。これらはツールチェイニングをサポートする可能性がありますが、HyperterseはMCPサーバ動作と宣言的ツールコンパイルを基準準拠インターフェースに特化しています。