Up-to-Date Docs MCP Server

Este espacio de trabajo contiene un pequeño servidor MCP para inspeccionar proyectos y obtener URLs de documentación conocidas mientras trabajas. Está diseñado para proyectos mixtos: repositorios de software, carpetas de electrónica, firmware, trabajo con KiCad/PlatformIO/Arduino, archivos SPICE y depuración con muchas hojas de datos.

El servidor es intencionalmente Python solo con la biblioteca estándar para que pueda ejecutarse sin npm install. Primero usa el cliente HTTP integrado de Python y recurre a la obtención verificada con curl -L cuando el almacén de certificados local de Python falta o está desactualizado.

Lo que proporciona

• analyze_project: escanea una carpeta de proyecto en busca de manifiestos, dependencias, frameworks, archivos de firmware/electrónica y posibles temas de documentación.

• fetch_doc: obtiene una página de documentación o URL de hoja de datos y devuelve texto legible. HTML funciona de serie. Los PDF son mejores si pypdf o pdftotext están instalados.

• context7_search: búsqueda opcional contra Context7 para documentación de bibliotecas de software.

• context7_docs: obtención opcional de documentación de Context7 después de resolver un ID de biblioteca.

Related MCP server: GitHub Repo Explainer MCP

Prueba rápida de humo

python3 up_to_date_docs_mcp.py --self-test

Configuración genérica de MCP

Usa la ruta absoluta a este script:

{
  "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"
      }
    }
  }
}

Mantén up_to_date_docs_mcp.py en la misma carpeta que los archivos auxiliares docs_mcp_*.py. El punto de entrada importa esos módulos en tiempo de ejecución.

Para una configuración verdaderamente proyecto por proyecto, ya sea:

• establece el directorio de trabajo del servidor a la carpeta del proyecto en tu cliente MCP, o

• cambia DOCS_MCP_PROJECT_ROOT cuando cambies de proyecto, o

• pasa un argumento path al llamar a analyze_project.

Configuración de Codex

Codex lee los servidores MCP desde su configuración global. Si el comando codex está en tu PATH, registra este servidor con:

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"

Si tu terminal dice codex: command not found, usa la CLI de Codex incluida en la aplicación de 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"

Confirma que Codex puede verlo:

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

Inicia una nueva sesión de Codex después de agregar el servidor y luego ejecuta:

/mcp

Deberías ver up-to-date-docs listado como un servidor MCP habilitado. Desde allí, pide a Codex que use up-to-date-docs para analizar un proyecto u obtener una URL de documentación.

Context7 opcional

Context7 es útil para bibliotecas de software porque tiene documentación indexada por biblioteca. Este servidor sigue funcionando sin él, pero puedes agregar:

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

Luego usa context7_search primero, seguido de context7_docs.

Ejemplos de prompts

• "Analiza este proyecto y sugiere temas de documentación para el framework principal."

• "Obtén esta URL de hoja de datos y resume las clasificaciones máximas absolutas."

• "Usa Context7 para obtener la documentación actual de FastAPI sobre inyección de dependencias."

• "Analiza esta carpeta de firmware y sugiere temas de documentación para buscar."

Notas

• El servidor obtiene páginas web en vivo cuando se le dan URLs, por lo que tu cliente MCP debe permitir acceso a la red para el proceso del servidor.

• La búsqueda web general no se expone intencionalmente hasta que haya un backend de búsqueda confiable.

• Soporta el flujo más nuevo server/discover y el flujo más antiguo initialize, lo que ayuda en diferentes clientes MCP.

• La extracción de PDF es opcional. Para trabajo de electrónica, instalar pypdf o pdftotext de Poppler hace que las hojas de datos sean mucho más útiles.

• Los registros van a stderr para que stdout permanezca reservado para los mensajes del protocolo MCP.