UV Documentation MCP Server

UV ドキュメント MCP サーバー

標準化された API を通じてUVドキュメントにプログラムからアクセスできる MCP サーバーです。このサーバーでは、最新の階層型リソース構造を採用しており、高レベルのドキュメントセクションと詳細なコマンドドキュメント（サブセクションを含む）の両方を個別の MCP リソースとして公開します。ツールを整理し、多くのドキュメント検索をリソースレイヤーで処理するようになりました。

リンク

• UV ドキュメント
• MCP Python SDK

クイックスタート

1. 要件：
   Python 3.13 以降がインストールされていることを確認してください（MCP SDK との互換性を保つには、最低でも 3.10 が必要です）。

2. リポジトリをクローン：

   git clone https://github.com/StevenBtw/uv-docs-mcp.git
   cd uv-docs-mcp
   

3. 仮想環境をセットアップして依存関係をインストール：

   python3.13 -m venv env
   source env/bin/activate   # On Windows use: env\\Scripts\\activate
   pip install -e .
   

4. サーバーを実行：

   uv run uv-docs
   

   (Claude Desktop やその他の MCP クライアントを使用する場合は、それに応じて設定を調整してください。)

アーキテクチャ

このサーバーは、関心事を明確に分離するモジュール型の階層設計で構築されています。

flowchart TD
    Client[MCP Client] --> Server[Server Layer]
    Server --> Resources[Resource Layer]
    Server --> Tools[Tools Layer]
    Server --> Prompts[Prompts Layer]
    
    Resources --> Cache[Cache System]
    Tools --> Cache

• リソースレイヤー：
  uv-docs:// スキームの URI を通じて UV ドキュメントを公開します。リソースは階層構造になっています。

  • レベル 1： 基本セクション（例：uv-docs://cli、uv-docs://settings、uv-docs://resolver）
  • レベル 2： 個々のコマンド（例：uv-docs://cli/uv-run、uv-docs://cli/uv-cache）
  • レベル 3： コマンドのサブセクション（例：uv-docs://cli/uv-cache/uv-cache-dir）

• ツールレイヤー：
  キャッシュとのやり取りやリアルタイム検索を行う操作コマンドを提供します。

  • update_cache： ライブ版が異なる場合に、ドキュメントキャッシュを更新します。
  • search_documentation： リアルタイムのクエリ実行を使用して UV ドキュメントを検索します。

• プロンプトレイヤー：
  AI アシスタントがドキュメントの要約を生成するためのプロンプトテンプレートを提供します（例：summarize-docs プロンプト）。

コンポーネント

リソース

リソースは uv-docs:// URI スキームを使用してアクセスし、ドキュメントの完全な階層構造を提供します。例：

• 基本セクション：
  uv-docs://cli は、すべての CLI コマンドの一覧を返します。

• コマンドレベル：
  uv-docs://cli/uv-cache は、利用可能なドキュメントセクションを含む、uv cache コマンドのメタデータを返します。

• サブセクションレベル：
  uv-docs://cli/uv-cache/uv-cache-dir は、「uv cache dir」セクションの詳細なドキュメント内容を返します。

各リソースは、詳細なメタデータと、要求された場合はドキュメント全文を含む JSON データを返します。この細かな分類により、MCP クライアントや AI アシスタントは必要な情報だけを照会できます。

ツール

利用可能なツールを整理しました。

1. update_cache
   • 目的： ライブ版が変更されている場合に、ドキュメントキャッシュを更新します。
   • 入力：

     {
       "force": false
     }
     

2. search_documentation
   • 目的： UV ドキュメントをリアルタイムで検索します。
   • 入力：

     {
       "query": "search query"
     }
     

プロンプト

このサーバーは、一般的なドキュメント作業向けに、あらかじめ用意されたプロンプトテンプレートを提供します。

• summarize-docs：
  UV ドキュメントの各セクションの要約を作成します。
  省略可能な引数：

  {
    "section": "cli|settings|resolver"
  }
  

  セクションが指定されていない場合は、すべてのセクションの要約が生成されます。

インストールと設定

MCP サーバーの設定

Claude Desktop やその他のシステムでは、適宜 MCP サーバーの設定を変更してください。

開発用／未公開の設定

{
  "mcpServers": {
    "uv-docs": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/steven/Git/MCP/uv-docs",
        "run",
        "uv-docs"
      ]
    }
  }
}

公開済みの設定

{
  "mcpServers": {
    "uv-docs": {
      "command": "uvx",
      "args": [
        "uv-docs"
      ]
    }
  }
}

デバッグと検査

詳細なデバッグには、MCP Inspectorを使用してください。

npx @modelcontextprotocol/inspector uv --directory /Users/steven/Git/MCP/uv-docs run uv-docs

キャッシュ

サーバーは、ドキュメントの取得を最適化するため、バージョンを考慮したキャッシュシステムを実装しています。

• 初期化： 起動時にキャッシュが自動的に初期化されます。
• バージョン確認： 最新のドキュメントのバージョンをキャッシュ済みのバージョンと照合します。
• セグメント化されたキャッシュ： 各ドキュメントセクション（例：CLI、設定、リゾルバー）は個別にキャッシュされます。
• 手動更新： 必要に応じて update_cache ツールを使用します。

開発

プロジェクト構成

uv-docs/
├── src/
│   └── uv_docs/
│       ├── __init__.py
│       ├── server.py         # Server setup and routing
│       ├── resources.py      # Resource handling and MCP resource interface
│       ├── cache.py          # Version-aware cache system
│       ├── prompts.py        # Prompt templates for documentation tasks
│       └── tools.py          # Consolidated tool implementations (update_cache, search_documentation)
├── pyproject.toml            # Project configuration
└── README.md                # Project overview (this file)

ビルドと公開

1. 依存関係とロックファイルを同期する：

   uv sync
   

2. パッケージ配布物をビルドする：

   uv build
   

3. PyPI に公開する：

   uv publish
   

注： PyPI の認証情報は次の方法で設定します。

• トークン：--token または環境変数 UV_PUBLISH_TOKEN
• またはユーザー名とパスワード：--username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

最適なデバッグ環境を利用するには、MCP Inspector を使用してください。

npx @modelcontextprotocol/inspector uv --directory /Users/steven/Git/MCP/uv-docs run uv-docs

Inspector に、ブラウザベースのデバッグ用 URL が表示されます。

キャッシュ

サーバーは、バージョンを考慮したキャッシュシステムを実装しています。

• サーバーの起動時にキャッシュが初期化されます
• 最新のドキュメントとバージョンを照合します
• バージョンが変わると自動的に更新します
• update_cache ツールを使って手動で更新します
• 各ドキュメントセクションは個別にキャッシュされます