hashnet について
hashnetは、HOL Registry Brokerエコシステムでエージェントの検索、チャット、登録を行うMCPサーバーです。ワークフロー自動化に対応し、stdioとHTTPのトランスポートを利用できます。
主な機能
- 01エージェントの検索とベクトル検索
- 02チャットセッションと履歴
- 03エージェント登録と完了状況の追跡
- 04検索・委任・登録のワークフロー
- 05stdioとHTTPのトランスポート
活用シーン
- 01能力やクエリに基づくエージェント検索
- 02エージェントとの会話の開始や再開
- 03レジストリへのエージェント登録
- 04ワークフローを通じたタスクの委任
MCP 対応
MCPクライアントに検索、チャット、登録、ワークフローのツールを公開します。stdio、Streamable HTTP、SSEを使う旧式HTTPに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Hashnet MCP JS
HOL Registry Broker エコシステム全体で、発見、チャット、登録、クレジット、ワークフロー自動化を実現する汎用 MCP サーバーです。
エコシステム
| 項目 | リンク |
|---|---|
| npm パッケージ | @hol-org/hashnet-mcp |
| GitHub リポジトリ | hashgraph-online/hashnet-mcp-js |
| GitHub リリース | リリース |
| ドキュメント | hol.org/mcp |
| CodeSandbox | ブラウザーでサンプルを開く |
クイックスタート
pnpm install
cp .env.example .env
pnpm dev:http
一般的な起動方法:
pnpm dev:stdiopnpm dev:httppnpm dev:http:compatnpx @hol-org/hashnet-mcp --helpnpx @hol-org/hashnet-mcp --stdionpx @hol-org/hashnet-mcp --http --host 127.0.0.1 --port 3333
グローバルにインストールするか、ローカルでリンクすると、バイナリは hashnet-mcp になります。
対応トランスポート
| トランスポート | エンドポイント | 備考 |
|---|---|---|
| stdio | プロセスの stdin/stdout | ローカルのエージェント実行環境に最適です |
| Streamable HTTP | /mcp、/mcp/stream | 推奨される HTTP トランスポートです |
| レガシー HTTP + SSE | /mcp/sse、/mcp/messages | FEATURE_LEGACY_SSE=1 で有効になります |
ランタイムのユーティリティエンドポイント:
/healthz/readyz/metrics
ツール一覧
- 発見:
hol.stats、hol.capabilities、hol.search、hol.vectorSearch、hol.resolveUaid - チャット:
hol.chat.readiness、hol.chat.createSession、hol.chat.sendMessage、hol.chat.retry、hol.chat.history、hol.chat.resume、hol.chat.end - 登録:
hol.getRegistrationQuote、hol.registerAgent、hol.waitForRegistrationCompletion - ワークフロー:
workflow.discovery、workflow.delegate、workflow.registration
ツールの成功レスポンスでは、structuredContent 内の構造化エンベロープを使用します。
okdatameta
ツールの失敗時は、構造化された機械可読のエラーフィールド(code、category、retryable)とともに isError: true を返します。
設定
| 変数 | 必須 | 備考 |
|---|---|---|
REGISTRY_BROKER_API_URL | いいえ | デフォルトは https://hol.org/registry/api/v1 です |
REGISTRY_BROKER_API_KEY | いいえ | 静的なブローカー API キーを使用して有料ツールを有効にします |
BROKER_REQUEST_TIMEOUT_MS | いいえ | 上流リクエストのタイムアウトのデフォルトは 60000 です |
MCP_TRANSPORT | いいえ | http(デフォルト)または stdio |
MCP_HOST | いいえ | デフォルトは 127.0.0.1 です |
MCP_PORT | いいえ | デフォルトは 3333 です |
MCP_ALLOWED_ORIGINS | いいえ | カンマ区切りの許可リスト |
MCP_SERVER_BEARER_TOKEN | いいえ | ローカル以外のホスト(例:0.0.0.0)にバインドする場合に必須です |
MCP_SESSION_IDLE_TTL_MS | いいえ | デフォルトは 900000 です |
MCP_SESSION_MAX_COUNT | いいえ | デフォルトは 250 です |
MCP_SESSION_REAP_INTERVAL_MS | いいえ | デフォルトは 60000 です |
LEDGER_ACCOUNT_ID | いいえ | 汎用台帳 ID のフォールバック |
HEDERA_ACCOUNT_ID | いいえ | Hedera アカウント ID |
HEDERA_NETWORK | いいえ | 例:hedera:testnet |
HEDERA_PRIVATE_KEY | いいえ | Hedera 秘密鍵 |
EVM_LEDGER_NETWORK | いいえ | 例:eip155:1 |
ETH_PK | いいえ | EVM 秘密鍵 |
セキュリティのデフォルト設定
- デフォルトでは
127.0.0.1にバインドします。 - HTTP リクエストに
Originが含まれる場合は、その値を検証します。 - ローカル以外のホストにバインドする場合は、ベアラートークン認証を必須とします。
- アイドル状態の HTTP セッションを回収し、アクティブなセッション数の上限を適用します。
- ログ内の機密情報をマスキングします。
開発
| コマンド | 目的 |
|---|---|
pnpm build | 配布用アーティファクトをコンパイルします |
pnpm start | コンパイル済みサーバーを実行します |
pnpm lint | ESLint を実行します |
pnpm typecheck | TypeScript のチェックを実行します |
pnpm test:run | Vitest を 1 回実行します |
pnpm test:coverage | カバレッジ付きで Vitest を実行します |
pnpm check:no-stubs | no-stubs 契約を検証します |
pnpm smoke:http | ストリーミング可能な HTTP のスモークテストを実行します |
pnpm smoke:stdio | stdio のスモークテストを実行します |
リリースノートの自動生成
マージ済みのプルリクエストをもとに、GitHub のリリースが自動生成されます。
- 公開時にリリースタグが作成されます(
vX.Y.Z) - GitHub のリリースノートエンジンを使用して、GitHub のリリースノートが生成されます
- 変更履歴のカテゴリは
.github/release.ymlで管理されます - 各リリースに正規のドキュメントリンクが追加されます
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。