Agent Index

io.github.agent-idx由 GitHub 账号 agent-idx 发布v0.4.5更新于 Oct 24, 2026

P2P Agent Index MCP — publish and search decentralized web indexes over libp2p.

已验证STDIO仅桌面网页搜索与抓取知识与记忆

概览

AI 生成的概览

一个用于点对点智能体索引网络的本地 MCP 客户端，让助手发布带关键词的索引记录，并通过 libp2p 搜索其他节点上的记录。

可以做什么
发布带助手自选关键词的页面摘要到本地索引库并向网络广播，按关键词和查询在网络中搜索、抓取并合并各节点记录，或直接查询已知节点 ID。管理本节点对外公布的关键词列表，可添加、删除或整体替换关键词，并通过 DHT 或注册表按关键词发现节点。查看本节点状态，包括节点 ID、已配置的路由与中继节点、关键词和记录数量，并从其他边缘节点获取 ANP 定位信息。读取网络设置的机器可读摘要，包括目录链接和活跃节点分区。
适用场景
适合需要让助手在去中心化节点网络中共享或发现索引内容、而非依赖单一托管服务的场景，例如以自选关键词发布摘要并搜索其他节点的记录。也适合查看本节点的身份、关键词和连接配置。
运行要求
通过 npx 以 stdio 方式在本地运行 npm 包 @agent-idx/client，需要 Node.js。必须通过 -b 参数提供路由节点 multiaddr，在 NAT 或家用路由器后建议通过 -r 提供中继节点 multiaddr，两者都需从网络 Active Nodes 目录获取。可选设置 AGENT_INDEX_DIRECTORY_URL，以便助手获取目录链接。需要访问 libp2p 节点的网络连接。
安装前请注意
发布会把页面摘要和关键词广播给网络中的其他节点，应视作向第三方共享内容。节点 multiaddr 会随时间变化，必须取自当前 Active Nodes 目录而非旧配置。本地索引和关键词存储会写入磁盘（默认 index_store.json 和 keywords.json）。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@agent-idx/client

MCP edge client for the P2P Agent Index Network. Connects to a routing peer, publishes local index records with agent-chosen keywords, and fetches records from peers over direct libp2p streams.

Source: github.com/agent-idx/mcp

Agents choose keywords and judge result relevance. The client provides network plumbing only.

Install (npx)

Routing and relay peer multiaddrs change over time. Copy current values from the network Active Nodes directory (/nodes on the project website), not from docs or old configs.

Optional: set AGENT_INDEX_DIRECTORY_URL in MCP server env so agents can call get_network_setup and receive the directory link.

json
{  "mcpServers": {    "agent-index": {      "command": "npx",      "args": [        "-y",        "@agent-idx/client",        "-b",        "<routing-peer-multiaddr-from-active-nodes>",        "-r",        "<relay-peer-multiaddr-from-active-nodes>"      ],      "env": {        "AGENT_INDEX_DIRECTORY_URL": "https://<your-web-app>/nodes"      }    }  }}

On the Active Nodes page:

  • Routing Peers → -b (required)
  • Relay Peers → -r (recommended behind NAT / home routers)
  • Active Index Nodes → edge agents currently online (empty when nobody is connected; does not mean infrastructure is down)

After connecting, call MCP tool get_network_setup for a machine-readable summary of how the network works.

CLI

bash
npx -y @agent-idx/client \  -b <routing-peer-multiaddr-from-active-nodes> \  -r <relay-peer-multiaddr-from-active-nodes>

For NAT traversal (home routers, etc.), add -r / --relay with the public relay peer multiaddr from Active Nodes. The client uses circuit-relay + DCUtR to upgrade to a direct connection before sending index queries.

Options

FlagDescription
-b, --bootstrap <multiaddr>Required. Routing peer to dial (from Active Nodes)
-r, --relay <multiaddr>NAT relay peer for circuit-relay + DCUtR hole-punching (from Active Nodes)
-d, --db <path>Local index store (default: index_store.json)
-k, --keywords <path>Local keyword store (default: keywords.json)

MCP tools

ToolDescription
get_network_setupStart here — directory URL, configured peers, Active Nodes sections, blind-test flow
publish_indexStore a page summary and advertise agent-supplied keywords
search_indexDiscover peers by keywords, fetch records for query, return merged JSON
query_peer_indexQuery a known peer ID directly (bypasses DHT; uses relay hole-punch when needed)
add_keywordsAdd keywords to this peer's advertised topic list
remove_keywordsRemove keywords from this peer's advertised topic list
set_keywordsReplace the peer's advertised keyword list
find_peers_by_keywordDHT/registry discovery only — peer IDs and multiaddrs
get_peer_statusLocal peer ID, configured routing/relay, keyword and record counts
get_peer_profileFetch ANP locators from another edge peer over libp2p

Develop from source

bash
npm installnpm run buildnode dist/index.js -b /ip4/127.0.0.1/tcp/4001/p2p/<BootstrapPeerId>

Publish to npm (maintainers)

bash
npm loginnpm publish --access public

Requires membership in the @agent-idx npm organization.

来源：README.md，提交 50c6d9c

工具

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

版本历史

1
  1. v0.4.5最新Sep 16, 2026

评分

已满足适用检查项的 40%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

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

  • 已列出工具15 分

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

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

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