Up-to-Date Docs MCP 服务器

此工作区包含一个小型 MCP 服务器，用于在您工作时检查项目并获取已知的文档 URL。它专为混合项目设计：软件仓库、电子文件夹、固件、KiCad/PlatformIO/Arduino 工作、SPICE 文件以及大量数据手册调试。

该服务器特意采用仅使用标准库的 Python 编写，因此无需 npm install 即可运行。它首先使用 Python 内置的 HTTP 客户端，当本地 Python 证书存储缺失或过期时，则回退到经过验证的 curl -L 获取方式。

提供的功能

• analyze_project：扫描项目文件夹，查找清单、依赖项、框架、固件/电子文件以及可能的文档主题。

• fetch_doc：获取文档页面或数据手册 URL 并返回可读文本。HTML 开箱即用。如果安装了 pypdf 或 pdftotext，PDF 的效果会更好。

• context7_search：可选功能，针对软件库文档搜索 Context7。

• context7_docs：在您解析库 ID 后，可选地获取 Context7 文档。

Related MCP server: GitHub Repo Explainer MCP

快速冒烟测试

python3 up_to_date_docs_mcp.py --self-test

通用 MCP 配置

使用此脚本的绝对路径：

{
  "mcpServers": {
    "up-to-date-docs": {
      "command": "python3",
      "args": [
        "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/up_to_date_docs_mcp.py"
      ],
      "env": {
        "DOCS_MCP_PROJECT_ROOT": "/path/to/your/current/project"
      }
    }
  }
}

将 up_to_date_docs_mcp.py 与 docs_mcp_*.py 辅助文件放在同一文件夹中。入口点在运行时导入这些模块。

如需真正按项目进行设置，您可以：

• 在 MCP 客户端中将服务器工作目录设置为项目文件夹，或

• 在切换项目时更改 DOCS_MCP_PROJECT_ROOT，或

• 在调用 analyze_project 时传入 path 参数。

Codex 设置

Codex 从其全局配置中读取 MCP 服务器。如果 codex 命令在您的 PATH 中，请使用以下方式注册此服务器：

codex mcp add up-to-date-docs \
  --env DOCS_MCP_PROJECT_ROOT="/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS" \
  -- "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/.venv/bin/python" \
  "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/up_to_date_docs_mcp.py"

如果您的终端提示 codex: command not found，请使用 ChatGPT 应用内置的 Codex CLI：

/Applications/ChatGPT.app/Contents/Resources/codex mcp add up-to-date-docs \
  --env DOCS_MCP_PROJECT_ROOT="/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS" \
  -- "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/.venv/bin/python" \
  "/Users/williamramsay/Documents/MCP SERVER FOR UP TO DATE DOCS/up_to_date_docs_mcp.py"

确认 Codex 可以看到它：

/Applications/ChatGPT.app/Contents/Resources/codex mcp list

添加服务器后启动新的 Codex 会话，然后运行：

/mcp

您应该会看到 up-to-date-docs 被列为已启用的 MCP 服务器。然后，您可以要求 Codex 使用 up-to-date-docs 来分析项目或获取文档 URL。

可选的 Context7

Context7 对软件库很有用，因为它按库索引了文档。此服务器在没有它的情况下也能正常工作，但您可以添加：

{
  "env": {
    "CONTEXT7_API_KEY": "your_key_here"
  }
}

然后先使用 context7_search，再使用 context7_docs。

示例提示词

• "分析此项目，并为主要框架建议文档主题。"

• "获取此数据手册 URL 并总结绝对最大额定值。"

• "使用 Context7 获取最新的 FastAPI 依赖注入文档。"

• "分析此固件文件夹并建议需要查阅的文档主题。"

注意事项

• 服务器在给定 URL 时会获取实时网页，因此您的 MCP 客户端必须允许服务器进程访问网络。

• 在拥有可靠搜索后端之前，有意不开放通用网络搜索。

• 它支持较新的 server/discover 流程和较旧的 initialize 流程，这有助于兼容不同的 MCP 客户端。

• PDF 提取是可选的。对于电子相关工作，安装 pypdf 或 Poppler 的 pdftotext 会使数据手册更加实用。

• 日志输出到 stderr，以便 stdout 保留给 MCP 协议消息。