Agent Wikis

agentwikis-mcp

面向 Agent Wikis 的 MCP 服务——由杂乱且快速变化的来源汇编而成、持续维护且便于 Agent 阅读的知识库。只读；免费层无需 API 密钥或账户，可选的 Pro 密钥可解锁 XL 层。

为 Agent 的工作循环设计的四种工具：

工具	功能
list_wikis	列出所有 wiki 及其声明的范围（涵盖 / 不涵盖 / 截至时间）
open_wiki	获取单个 wiki 的元数据和完整文档映射——一次调用即可了解整体情况
search	返回经过排序的页面，并附带校准后的 confident 标记——若为 false，则改用网页搜索
read_document	返回完整页面或单个章节，并附带来源说明

声明覆盖范围和 confident 标记，是为了让 Agent 知道何时不该相信 wiki——经测量，正确弃答率约为 94%。详情和完整评估见：agentwikis.com/why-wikis。

安装

Claude Code

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

Codex（~/.codex/config.toml）

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

任意 MCP 客户端（JSON 配置）

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

Pro（XL）访问权限

Wiki 分为两个层级：免费的 wiki/ 页面，以及随 Agent Wikis Pro 提供的更深入的 XL 层级逐项参考页面。

将 AGENTWIKIS_API_KEY 设置为你的 Pro 密钥，三个读取工具便都会扩展到该层级：

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

Hermes Agent： 将密钥保存在个人资料的 .env 文件中，并在 config.yaml 中进行映射。Hermes 只会将配置的 env 传给 stdio 服务，不会传递 .env 文件本身。如果未设置该变量，服务会回退到免费层。

mcp_servers:
  agentwikis:
    command: npx
    args: ["-y", "agentwikis-mcp"]
    env:
      AGENTWIKIS_API_KEY: "${AGENTWIKIS_API_KEY}"

	不使用密钥	使用 Pro 密钥
open_wiki	免费页面；xl 字段显示 Pro 页面数量	免费 + XL 页面，XL 页面标记为 gated: true
search	仅搜索免费页面；xl 字段报告有多少 Pro 页面未参与搜索	跨两个层级排序，confident 根据完整语料库进行校准
read_document	对 XL 路径返回 402	返回 XL 页面

不使用密钥时，confident: true 的搜索结果表示“最佳的免费页面涵盖了你的搜索词”——响应中的 xl 字段会告知你有多少内容不可见。

路由提示。 XL 页面提供的是逐项深入内容，而非更广泛的覆盖范围。当问题提到特定插件、钩子、CLI 接口、运行时、API 或部署流程时，优先选择 gated: true 页面，而不是一般概念页面。

自托管实例

将桥接程序指向你自己的 Agent Wikis 部署（例如私有 wiki 安装）：

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

内容简介

桥接程序会与 agentwikis.com/api/* 通信，并返回与自托管 stdio 服务相同的载荷——文档格式、来源说明和搜索校准均相同。需要 Node 18+。

Agent Wikis 也会以纯 Markdown 和 llms.txt 的形式提供全部内容；如果你想完全跳过 MCP，请参阅 agentwikis.com/for-agents。

许可证

MIT