Agent Wikis

io.github.tonbistudio由 GitHub 帳號 tonbistudio 發布v0.2.3更新於 Oct 30, 2026

Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.

概覽

AI 產生的概覽

唯讀的 Agent Wikis MCP 橋接服務,讓助理列出、搜尋並閱讀附有範圍說明與信心訊號的維護型知識庫。

可以做什麼
  • 列出所有可用 wiki 及其中繼資料、標籤與宣告範圍(涵蓋內容、未涵蓋內容、更新時效)
  • 一次呼叫即可熟悉某個 wiki,回傳其中繼資料、入口文件與依資料夾分組的文件地圖
  • 在單一 wiki 或全部啟用中的 wiki 搜尋頁面,依查詢詞符合度排序,並提供 confident 標記與摘要片段
  • 讀取整份文件或只讀取某個章節(依標題或錨點),並附上來源註腳
適用情境
適合助理需要針對快速變動的技術主題取得經過整理、便於代理閱讀的參考資料,並且需要知道 wiki 未涵蓋某問題時改採網頁搜尋而非憑空猜測的情境。
執行需求
透過 npx 以 stdio 在本機執行,需要 Node 18 以上版本。免費層不需帳號或金鑰;選用的 AGENTWIKIS_API_KEY 可啟用 Pro(XL)層。AGENTWIKIS_URL 可指向自架執行個體,預設為 agentwikis.com。需要能連線至該 API 的網路。
安裝前請注意
服務為唯讀,不會寫入、傳送或刪除資料。選用的 AGENTWIKIS_API_KEY 屬於機密,應透過環境變數提供,不要寫進設定檔。查詢與文件請求會送往所設定的 Agent Wikis 執行個體,預設為第三方託管服務;改用自架位址會改變資料去向。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Agent Wikis,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

agentwikis-mcp

MCP server for Agent Wikis — maintained, agent-readable knowledge bases compiled from messy, fast-moving sources. Read-only; no API key or account needed for the free tier, and an optional Pro key adds the XL tier.

Four tools shaped for an agent's loop:

ToolWhat it does
list_wikisEvery wiki + its declared scope (covers / not covered / current-as-of)
open_wikiOne wiki's metadata + full document map — orient in a single call
searchRanked pages with a calibrated confident flag — when false, fall back to web search
read_documentFull page or a single section, with a provenance footer

The scope declarations and the confident flag exist so your agent knows when not to trust the wiki — measured ~94% correct abstention. Details and the full eval: agentwikis.com/why-wikis.

Install

Claude Code

bash
claude mcp add agentwikis -- npx -y agentwikis-mcp

Codex (~/.codex/config.toml)

toml
[mcp_servers.agentwikis]command = "npx"args = ["-y", "agentwikis-mcp"]

Any MCP client (JSON config)

json
{ "mcpServers": { "agentwikis": { "command": "npx", "args": ["-y", "agentwikis-mcp"] } } }

Pro (XL) access

Wikis ship in two tiers: the free wiki/ pages, and an XL tier of deeper per-item reference pages included with Agent Wikis Pro.

Set AGENTWIKIS_API_KEY to your Pro key and all three read tools widen to cover it:

json
{  "mcpServers": {    "agentwikis": {      "command": "npx",      "args": ["-y", "agentwikis-mcp"],      "env": { "AGENTWIKIS_API_KEY": "aw_..." }    }  }}

Hermes Agent: keep the key in your profile's .env and map it in config.yaml. Hermes passes a stdio server only its configured env, never the .env itself. If the variable is unset, the server falls back to the free tier.

yaml
mcp_servers:  agentwikis:    command: npx    args: ["-y", "agentwikis-mcp"]    env:      AGENTWIKIS_API_KEY: "${AGENTWIKIS_API_KEY}"
Without a keyWith a Pro key
open_wikifree pages; an xl field says how many Pro pages existfree + XL pages, XL marked gated: true
searchfree pages only; an xl field reports how many Pro pages were not searchedranks across both tiers, confident calibrated over the full corpus
read_document402 on an XL pathreturns the XL page

Without a key, a confident: true search result means "the best free page covers your terms" — the xl field on the response tells you how much you didn't see.

Routing tip. XL pages are per-item depth, not broader coverage. When a question names a specific plugin, hook, CLI surface, runtime, API, or deployment procedure, prefer the gated: true page over the general concept page.

Self-hosted instances

Point the bridge at your own Agent Wikis deployment (e.g. a private-wiki install):

bash
AGENTWIKIS_URL=https://wikis.internal.example npx -y agentwikis-mcp

What's inside

The bridge talks to agentwikis.com/api/* and returns the same payloads as the self-hosted stdio server — same document formatting, same provenance footers, same search calibration. Requires Node 18+.

Agent Wikis also serves everything as plain Markdown + llms.txt if you'd rather skip MCP entirely: see agentwikis.com/for-agents.

License

MIT

來源:README.md,提交 8d9397a

工具

4

list_wikis

List all available wikis with metadata: slug, title, description, tags, status, last updated, document count, and `scope` (what each wiki covers, what it does NOT cover, and how current it is — use this to pick a wiki and to decide when to fall back to web search). Includes "coming soon" placeholders, marked by status.

無需輸入參數。

open_wiki

Orient yourself in one wiki, in a single call: returns its metadata, `scope` (coverage / not-covered / freshness), document count, the entry document, and a `map` of all documents (paths + titles, grouped by folder) so you can pick what to read_document next. Use a slug from list_wikis. Free tier: the map omits Pro (XL) pages. The response's `xl` field says how many exist and where to list them; set AGENTWIKIS_API_KEY to include them.

輸入參數wiki必填

read_document

Read one document in a wiki. Without `section`, returns the full Markdown (frontmatter stripped) plus a provenance footer. To save tokens on a long page, pass `section` (a heading title as it appears in the page body, or its slug anchor) to retrieve ONLY that section and its subsections. The Markdown may contain [[wikilinks]] to related docs — follow one by calling read_document with path "wiki/<target>.md".

輸入參數path必填wiki必填section

版本歷史

1
  1. v0.2.3最新Oct 23, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分