Up-to-Date Docs MCP サーバー

このワークスペースには、作業中にプロジェクトを調査し、既知のドキュメント URL を取得するための小さな MCP サーバーが含まれています。ソフトウェアリポジトリ、エレクトロニクスフォルダ、ファームウェア、KiCad/PlatformIO/Arduino 作業、SPICE ファイル、データシート中心のデバッグなど、混在プロジェクト向けに設計されています。

このサーバーは意図的に stdlib のみの Python で構成されているため、npm install なしで実行できます。Python 組み込みの HTTP クライアントを最初に使用し、ローカルの Python 証明書ストアがないか古い場合は、検証済みの curl -L フェッチにフォールバックします。

提供される機能

• analyze_project: プロジェクトフォルダをスキャンして、マニフェスト、依存関係、フレームワーク、ファームウェア/エレクトロニクスファイル、および推定されるドキュメントトピックを探します。

• fetch_doc: ドキュメントページまたはデータシートの URL を取得し、読み取り可能なテキストを返します。HTML はそのまま動作します。PDF は pypdf または pdftotext がインストールされているとより適切に処理されます。

• 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 は、ライブラリごとにインデックス化されたドキュメントがあるため、ソフトウェアライブラリに役立ちます。このサーバーは Context7 なしでも動作しますが、以下を追加できます:

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

次に、最初に context7_search を使用し、続いて context7_docs を使用します。

プロンプトの例

• 「このプロジェクトを分析して、メインフレームワークのドキュメントトピックを提案してください。」

• 「このデータシートの URL を取得して、絶対最大定格を要約してください。」

• 「Context7 を使用して、依存性注入に関する最新の FastAPI ドキュメントを取得してください。」

• 「このファームウェアフォルダを分析して、調べるべきドキュメントトピックを提案してください。」

注意事項

• サーバーは URL が指定されるとライブ Web ページを取得するため、MCP クライアントはサーバープロセスへのネットワークアクセスを許可する必要があります。

• 一般的な Web 検索は、信頼性の高い検索バックエンドが利用可能になるまで意図的に公開されていません。

• 新しい server/discover フローと古い initialize フローの両方をサポートしており、さまざまな MCP クライアント間で役立ちます。

• PDF 抽出はオプションです。エレクトロニクス作業では、pypdf または Poppler の pdftotext をインストールすると、データシートがはるかに有用になります。

• ログは stderr に出力されるため、stdout は MCP プロトコルメッセージ用に予約されています。