agentdocs

Name: agentdocs
Author: titov-d

本地服务

github.com/titov-d开发工具04 周前更新

代码仓库

关于 agentdocs

agentdocs 是面向编码 Agent 的本地 MCP 服务，提供构建 MCP 服务和 Claude Agent 的经源核验文档。文档经人工审阅并标注来源，帮助 Agent 基于可追溯资料回答技术问题。

主要功能

01浏览文档主题及核验状态
02按查询检索排名片段
03读取完整 Markdown 文档
04提供上游来源链接
05人工核验文档并记录日期

适用场景

01查找 MCP 协议实现细节
02查询 Claude Agent SDK 用法
03核对来源并阅读完整文档

MCP 相关

它通过 stdio 在本地运行 MCP 服务，向 MCP 客户端提供主题列表、文档搜索和读取工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "titov-d-agentdocs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-agentdocs"
      ]
    }
  }
}

启动命令npx -y mcp-agentdocs

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-agentdocs0.1.3stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

agentdocs

为构建 MCP 服务和 Claude Agent 提供最新、经源验证的文档——通过 MCP 直接送达你的 AI 编码 Agent。

对于 Model Context Protocol 和 Claude Agent SDK 这类快速演进的 API，编码 Agent 常常会产生幻觉：训练数据落后于规范，导致它们给出看似合理却错误的导入方式、已弃用的模式和凭空捏造的选项。agentdocs 是一个本地 MCP 服务，为你的 Agent 提供经过整理、经源验证的语料库供其检索，而不是让它靠猜。

🔎 三个工具：list_topics、search_docs、get_doc
📎 每个回答都会标注其上游来源 URL
🏠 通过 stdio 本地运行——无需账户、无需托管，数据不会离开你的设备
✅ 每篇文档都包含一个 verified 标记，该标记仅在人为对照来源审核后设置

安装并连接

需要 Node.js 18+。

Claude Code

claude mcp add agentdocs -- npx -y mcp-agentdocs@latest

Cursor / 其他 MCP 客户端（`mcp.json`）

{
  "mcpServers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "mcp-agentdocs@latest"]
    }
  }
}

然后可以向你的 Agent 提问，例如 “在 agentdocs 中查找 MCP stdio 如何处理日志” 或 “在 agentdocs 中搜索 Streamable HTTP 会话标头”——它会调用这些工具，并根据经验证的语料库作答。

工具

工具	用途
`list_topics`	查看每篇整理后的文档、其主题、来源 URL 和验证状态
`search_docs(query, topic?)`	获取与问题相关的排序片段，并标注来源
`get_doc(id)`	阅读一篇文档的完整经验证 Markdown 内容

覆盖内容（v1）

Model Context Protocol（规范 2025-11-25）以及 MCP 服务 / Claude Agent 的构建。语料库会持续扩充；运行 list_topics 查看当前内容。

时效性

每篇文档都会记录其最近一次对照主要来源验证的日期。我们会定期比对来源；当来源发生变化时，会重新验证受影响的文档并发布新版本。使用 mcp-agentdocs@latest（如上所示）即可获取当前语料库。请参阅 CHANGELOG.md，了解变更内容和时间。

开发

npm install
npm run build      # tsc -> dist/
npm test           # vitest: retrieval, manifest integrity, unicode safety
npm run ingest     # refresh sources into corpus/_staging/ for human review

内容整理是本项目的核心：npm run ingest 会获取上游来源供审核，但绝不会悄悄覆盖已整理的文档——只有在人为对比并确认内容与来源一致后，才会将文档提升为正式版本，并在 corpus/manifest.json 中设置 verified: true。运行 npm run check-freshness，标记内容已发生变化或需要重新验证的文档。