novai-mcp-server

NOVAI MCP サーバー

MCP 対応エージェントが、公開 JSON-RPC エンドポイントを介して稼働中の NOVAI チェーンを照会できる、読み取り専用の Model Context Protocol（MCP）サーバーです。照会ツールのみを公開します。このパッケージには、書き込み、署名、送信、鍵の取り扱いを行う経路は一切ありません。

NOVAI は、チェーン型 BFT コンセンサスを採用した AI ネイティブなレイヤー 1 です。このサーバーは、型付きのシンプルなブリッジです。エージェントは標準の MCP ツールを通じてツールを検出し、SDK コードを一切書かずにチェーンを読み取れます。

安全性の境界

これはバージョン 0 であり、設計上、読み取り専用です。

• すべてのツールは、公開エンドポイント上の単一の読み取りメソッドに対応する照会です。
• このパッケージは秘密鍵を保持せず、署名もトランザクションの送信も行いません。
• チェーンが公開する書き込みメソッドは、意図的に接続していません。

要件

• Node.js 18 以降。

インストールと実行

npx で直接実行します。

npx novai-mcp-server

または、インストールしてバイナリを実行します。

npm install novai-mcp-server
novai-mcp-server

このサーバーは stdio 経由で MCP を使用します。上記のコマンドを MCP クライアントに指定してください。

MCP クライアント設定の例

{
  "mcpServers": {
    "novai": {
      "command": "npx",
      "args": ["novai-mcp-server"]
    }
  }
}

設定

• NOVAI_RPC_URL は JSON-RPC エンドポイントを上書きします。デフォルトは公開 NOVAI URL の https://rpc.novai.network です。公開エンドポイントはオープンかつ読み取り専用のため、その他の設定、シークレット、認証は必要ありません。

ツール

すべてのハッシュと ID は 64 桁の 16 進数（32 バイト、0x プレフィックスなし）です。すべての高さは 0 以上の整数です。ネットワーク呼び出しの前にすべての入力を検証します。また、チェーンエラーと通信障害は、スタックトレースを含まない明確なツールエラーとして返されます。

ツール	戻り値	必須パラメーター	任意パラメーター
novai_get_chain_status	最新のコミット済みブロック。チェーンが稼働中であることを確認し、先端の高さを把握できます	なし	なし
novai_get_block	単一のブロック	height または hash のいずれか一方	なし
novai_get_transaction	確定済みのトランザクション。不明な場合は null	txid	なし
novai_get_ai_entity	AI エンティティ（エージェント）のレコード。不明な場合は null	entity_id	なし
novai_get_balance	アドレスの残高（10 進数文字列）と nonce	address	なし
novai_get_signals_by_height	指定した高さで記録されたシグナルコミットメント	height	なし
novai_get_signals_by_issuer	高さの範囲内でエンティティが発行したシグナル	issuer, start_height, end_height	なし
novai_get_signals_by_type	高さの範囲内で指定したタイプのシグナル	signal_type, start_height, end_height	なし
novai_get_oracle_anchor	シグナルハッシュに対応するオラクルアンカー。不明な場合は null	signal_hash	なし
novai_get_oracle_anchors_by_entity	高さの範囲内で発行者ごとのオラクルアンカー	entity_id, start_height, end_height	ts_min, ts_max
novai_get_oracle_anchors_by_tag	高さの範囲内でデータタグごとのオラクルアンカー	data_tag, start_height, end_height	ts_min, ts_max
novai_get_memory_objects	エンティティが所有するオンチェーンのメモリーオブジェクト	entity_id	なし

高さによるブロック検索について

エンドポイントが高さによるブロック検索用に保持するのは、直近の限られた範囲のブロックです。そのため、現在の先端から大きく離れた高さを指定すると、有効なブロックであっても null が返される場合があります。ハッシュによる検索では、ノードがインデックスを保持しているブロックを検索できます。まず novai_get_chain_status を呼び出して、現在の先端の高さを確認してください。

開発

npm install
npm run build
npm test

npm test は、オフラインの単体テストと検証テストを実行します。稼働中のエンドポイントをテストするには、次のコマンドを実行します。

npm run test:live

ビルド済みサーバーを起動し、実際の MCP クライアントで操作する、stdio を使ったエンドツーエンドの確認も利用できます。

npm run build && node scripts/smoke.mjs

ライセンス

MIT。LICENSE ファイルを参照してください。