Сервер MCP «Up-to-Date Docs»

В этом рабочем пространстве находится небольшой MCP-сервер для просмотра проектов и получения известных URL-адресов документации во время работы. Он рассчитан на смешанные проекты: репозитории ПО, папки с электроникой, прошивки, работу с KiCad/PlatformIO/Arduino, SPICE-файлы и отладку с обилием даташитов.

Сервер намеренно написан на Python только со стандартной библиотекой, чтобы его можно было запускать без npm install. Он сначала использует встроенный HTTP-клиент Python, а при отсутствии или устаревании локального хранилища сертификатов Python переключается на проверенную загрузку через curl -L.

Что он предоставляет

• analyze_project: сканирует папку проекта на предмет манифестов, зависимостей, фреймворков, файлов прошивок/электроники и вероятных тем документации.

• fetch_doc: загружает страницу документации или URL-адрес даташита и возвращает читаемый текст. HTML работает из коробки. PDF-файлы обрабатываются лучше, если установлены pypdf или pdftotext.

• context7_search: необязательный поиск по документации программных библиотек через Context7.

• context7_docs: необязательная загрузка документации 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 при переключении между проектами, или

• передать аргумент path при вызове analyze_project.

Настройка 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, используйте встроенный Codex CLI из приложения ChatGPT:

/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.