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 分

    請在儲存庫或註冊中心條目中宣告授權條款。