Hashnet

io.github.hashgraph-online由 GitHub 账号 hashgraph-online 发布v1.0.24更新于 Oct 25, 2026

Universal AI Agent Discovery - search 59,000+ agents across MCP, NANDA, A2A, OpenRouter

已验证STDIO仅桌面知识与记忆AI 与机器学习

概览

AI 生成的概览

本地 MCP 服务器，用于跨注册表发现 AI 代理、与其对话、注册代理，并运行发现或委派工作流。

可以做什么
通过 hol 发现工具和发现工作流，在 MCP、NANDA、A2A 和 OpenRouter 中搜索和查看代理，包括向量搜索、统计、能力查询和 UAID 解析。创建、发送消息、重试、查看历史、恢复和结束与代理的聊天会话。获取注册报价、注册代理并等待注册完成，或运行注册工作流。运行结合发现与代理交互的委派工作流。
适用场景
适合需要让助手在多个代理注册表中寻找合适的代理或服务、与其对话，或通过 HOL Registry Broker 生态注册代理并委派任务的场景。
运行要求
以 npm 包形式在本地运行（需要 Node.js），默认通过 stdio 或 HTTP 在 127.0.0.1:3333 提供。需要访问 Registry Broker API 的网络连接，API 地址默认指向 hol.org，可覆盖。可选的 REGISTRY_BROKER_API_KEY 用于启用付费工具。
安装前请注意
可选的 REGISTRY_BROKER_API_KEY 会启用付费工具，使用可能产生费用。可选配置接受钱包凭据，包括 HEDERA_PRIVATE_KEY 和 ETH_PK，仅在了解风险时提供。聊天和注册工具会将数据发送到远程 Registry Broker 服务。绑定到非本地主机需要 MCP_SERVER_BEARER_TOKEN。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hashnet，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Hashnet MCP JS

[npm version] [npm downloads] [Node version] [Bundle size] [Publish] [Canary] [License] [CodeSandbox]

Universal MCP server for discovery, chat, registration, credits, and workflow automation across the HOL Registry Broker ecosystem.

Ecosystem

SurfaceLink
npm package@hol-org/hashnet-mcp
GitHub repohashgraph-online/hashnet-mcp-js
GitHub releasesReleases
Documentationhol.org/mcp
CodeSandboxOpen examples in browser

Quickstart

bash
pnpm installcp .env.example .envpnpm dev:http

Common launch modes:

  • pnpm dev:stdio
  • pnpm dev:http
  • pnpm dev:http:compat
  • npx @hol-org/hashnet-mcp --help
  • npx @hol-org/hashnet-mcp --stdio
  • npx @hol-org/hashnet-mcp --http --host 127.0.0.1 --port 3333

When installed globally or linked locally, the binary is hashnet-mcp.

Supported Transports

TransportEndpoint(s)Notes
stdioprocess stdin/stdoutbest for local agent runtimes
Streamable HTTP/mcp, /mcp/streamrecommended HTTP transport
legacy HTTP + SSE/mcp/sse, /mcp/messagesenabled with FEATURE_LEGACY_SSE=1

Runtime utility endpoints:

  • /healthz
  • /readyz
  • /metrics

Tool Surface

  • Discovery: hol.stats, hol.capabilities, hol.search, hol.vectorSearch, hol.resolveUaid
  • Chat: hol.chat.readiness, hol.chat.createSession, hol.chat.sendMessage, hol.chat.retry, hol.chat.history, hol.chat.resume, hol.chat.end
  • Registration: hol.getRegistrationQuote, hol.registerAgent, hol.waitForRegistrationCompletion
  • Workflows: workflow.discovery, workflow.delegate, workflow.registration

Tool success responses use structured envelopes in structuredContent:

  • ok
  • data
  • meta

Tool failures return isError: true with structured machine-readable error fields (code, category, retryable).

Configuration

VariableRequiredNotes
REGISTRY_BROKER_API_URLnodefaults to https://hol.org/registry/api/v1
REGISTRY_BROKER_API_KEYnoenables paid tools with a static broker API key
BROKER_REQUEST_TIMEOUT_MSnodefault upstream request timeout is 60000
MCP_TRANSPORTnohttp (default) or stdio
MCP_HOSTnodefaults to 127.0.0.1
MCP_PORTnodefaults to 3333
MCP_ALLOWED_ORIGINSnocomma-separated allow list
MCP_SERVER_BEARER_TOKENnorequired when binding to a non-local host (for example 0.0.0.0)
MCP_SESSION_IDLE_TTL_MSnodefaults to 900000
MCP_SESSION_MAX_COUNTnodefaults to 250
MCP_SESSION_REAP_INTERVAL_MSnodefaults to 60000
LEDGER_ACCOUNT_IDnogeneric ledger identity fallback
HEDERA_ACCOUNT_IDnoHedera account id
HEDERA_NETWORKnoe.g. hedera:testnet
HEDERA_PRIVATE_KEYnoHedera private key
EVM_LEDGER_NETWORKnoe.g. eip155:1
ETH_PKnoEVM private key

Security Defaults

  • Binds to 127.0.0.1 by default.
  • Validates Origin for HTTP requests when present.
  • Enforces bearer-token auth when binding to non-local hosts.
  • Reaps idle HTTP sessions and enforces max active sessions.
  • Redacts sensitive values in logs.

Development

CommandPurpose
pnpm buildcompile distributable artifacts
pnpm startrun compiled server
pnpm lintrun ESLint
pnpm typecheckrun TypeScript checks
pnpm test:runrun Vitest once
pnpm test:coveragerun Vitest with coverage
pnpm check:no-stubsenforce no-stubs contract
pnpm smoke:httpstreamable HTTP smoke test
pnpm smoke:stdiostdio smoke test

Release Notes Automation

GitHub releases are generated automatically from merged pull requests:

  • release tags are created during publish (vX.Y.Z)
  • GitHub release notes are generated with GitHub's release-note engine
  • changelog categories are controlled via .github/release.yml
  • canonical docs links are appended to each release

来源：README.md，提交 a7d4ac1

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.24最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。