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 分