Agent Index

@agent-idx/client

面向 P2P Agent Index Network 的 MCP 边缘客户端。连接到路由节点，发布本地索引记录（使用由 Agent 选择的关键词），并通过直接的 libp2p 流从节点获取记录。

源码：github.com/agent-idx/mcp

Agent 选择关键词并判断结果的相关性。客户端仅提供网络连接功能。

安装（npx）

路由节点和中继节点的 multiaddr 会随时间变化。 请从网络的活跃节点目录（项目网站上的 /nodes）复制当前值，不要使用文档或旧配置中的值。

可选：在 MCP 服务的 env 中设置 AGENT_INDEX_DIRECTORY_URL，以便 Agent 调用 get_network_setup 并获取目录链接。

{
  "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"
      }
    }
  }
}

在活跃节点页面上：

• 路由节点 → -b（必需）
• 中继节点 → -r（位于 NAT / 家用路由器后时建议使用）
• 活跃索引节点 → 当前在线的边缘 Agent（无人连接时为空；这不表示基础设施已宕机）

连接后，调用 MCP 工具 get_network_setup，获取网络工作方式的机器可读摘要。

CLI

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

对于 NAT 穿透（家用路由器等），请添加 -r / --relay，并填写活跃节点中的公共中继节点 multiaddr。客户端会使用 circuit-relay + DCUtR，在发送索引查询前升级为直接连接。

选项

标志	描述
-b, --bootstrap <multiaddr>	必需。 要拨号连接的路由节点（来自活跃节点）
-r, --relay <multiaddr>	用于 circuit-relay + DCUtR 打洞的 NAT 中继节点（来自活跃节点）
-d, --db <path>	本地索引存储（默认：index_store.json）
-k, --keywords <path>	本地关键词存储（默认：keywords.json）

MCP 工具

工具	描述
get_network_setup	从这里开始 — 目录 URL、已配置节点、活跃节点分区、盲测流程
publish_index	存储页面摘要，并发布 Agent 提供的 keywords
search_index	按 keywords 发现节点，为 query 获取记录，并返回合并后的 JSON
query_peer_index	直接查询已知节点 ID（绕过 DHT；需要时通过中继打洞）
add_keywords	将关键词添加到此节点发布的主题列表
remove_keywords	从此节点发布的主题列表中移除关键词
set_keywords	替换此节点发布的关键词列表
find_peers_by_keyword	仅进行 DHT/注册表发现 — 返回节点 ID 和 multiaddr
get_peer_status	本地节点 ID、已配置的路由 / 中继节点、关键词和记录数量
get_peer_profile	通过 libp2p 从另一个边缘节点获取 ANP 定位符

从源码开发

npm install
npm run build
node dist/index.js -b /ip4/127.0.0.1/tcp/4001/p2p/<BootstrapPeerId>

发布到 npm（维护者）

npm login
npm publish --access public

需要加入 npm 组织 @agent-idx。