Up-to-Date Docs MCP Server

Dieser Arbeitsbereich enthält einen kleinen MCP-Server zum Untersuchen von Projekten und Abrufen bekannter Dokumentations-URLs während der Arbeit. Er ist für gemischte Projekte konzipiert: Software-Repositories, Elektronikordner, Firmware, KiCad/PlatformIO/Arduino-Arbeiten, SPICE-Dateien und datenblattintensives Debugging.

Der Server ist absichtlich nur mit der Python-Standardbibliothek implementiert, sodass er ohne npm install ausgeführt werden kann. Er verwendet zuerst den eingebauten HTTP-Client von Python und greift auf verifiziertes curl -L-Abrufen zurück, wenn der lokale Python-Zertifikatsspeicher fehlt oder veraltet ist.

Was es bietet

• analyze_project: durchsucht einen Projektordner nach Manifesten, Abhängigkeiten, Frameworks, Firmware-/Elektronikdateien und wahrscheinlichen Dokumentationsthemen.

• fetch_doc: ruft eine Dokumentationsseite oder Datenblatt-URL ab und gibt lesbaren Text zurück. HTML funktioniert sofort. PDFs sind besser, wenn pypdf oder pdftotext installiert ist.

• context7_search: optionale Suche bei Context7 nach Dokumentation zu Software-Bibliotheken.

• context7_docs: optionaler Abruf von Context7-Dokumenten, nachdem Sie eine Bibliotheks-ID aufgelöst haben.

Related MCP server: GitHub Repo Explainer MCP

Schneller Smoke-Test

python3 up_to_date_docs_mcp.py --self-test

Generische MCP-Konfiguration

Verwenden Sie den absoluten Pfad zu diesem Skript:

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

Halten Sie up_to_date_docs_mcp.py im selben Ordner wie die Hilfsdateien docs_mcp_*.py. Der Einstiegspunkt importiert diese Module zur Laufzeit.

Für eine wirklich projektbezogene Einrichtung haben Sie folgende Möglichkeiten:

• Legen Sie das Arbeitsverzeichnis des Servers in Ihrem MCP-Client auf den Projektordner fest, oder

• Ändern Sie DOCS_MCP_PROJECT_ROOT, wenn Sie das Projekt wechseln, oder

• Übergeben Sie ein path-Argument, wenn Sie analyze_project aufrufen.

Codex-Einrichtung

Codex liest MCP-Server aus seiner globalen Konfiguration. Wenn der Befehl codex in Ihrem PATH ist, registrieren Sie diesen Server mit:

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"

Wenn Ihr Terminal codex: command not found meldet, verwenden Sie die gebündelte Codex-CLI der ChatGPT-App:

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

Bestätigen Sie, dass Codex es sehen kann:

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

Starten Sie nach dem Hinzufügen des Servers eine neue Codex-Sitzung und führen Sie dann aus:

/mcp

Sie sollten up-to-date-docs als aktivierten MCP-Server sehen. Bitten Sie Codex von dort aus, up-to-date-docs zu verwenden, um ein Projekt zu analysieren oder eine Dokumentations-URL abzurufen.

Optionales Context7

Context7 ist nützlich für Software-Bibliotheken, da es Dokumentation nach Bibliothek indiziert. Dieser Server funktioniert auch ohne, aber Sie können hinzufügen:

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

Verwenden Sie dann zuerst context7_search und danach context7_docs.

Beispiel-Prompts

• „Analysieren Sie dieses Projekt und schlagen Sie Dokumentationsthemen für das Hauptframework vor."

• „Rufen Sie diese Datenblatt-URL ab und fassen Sie die absoluten Maximalwerte zusammen."

• „Verwenden Sie Context7, um aktuelle FastAPI-Dokumente zur Abhängigkeitsinjektion zu erhalten."

• „Analysieren Sie diesen Firmware-Ordner und schlagen Sie Dokumentationsthemen zum Nachschlagen vor."

Hinweise

• Der Server ruft bei URLs Live-Webseiten ab, daher muss Ihr MCP-Client Netzwerkzugriff für den Serverprozess erlauben.

• Die allgemeine Websuche ist absichtlich nicht verfügbar, bis es ein zuverlässiges Such-Backend gibt.

• Er unterstützt den neueren server/discover-Ablauf und den älteren initialize-Ablauf, was bei verschiedenen MCP-Clients hilft.

• Die PDF-Extraktion ist optional. Für Elektronikarbeiten macht die Installation von pypdf oder Popplers pdftotext Datenblätter viel nützlicher.

• Logs gehen nach stderr, damit stdout für MCP-Protokollnachrichten reserviert bleibt.