Uv Docs MCP

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

このサーバーは、UV ドキュメントへのプログラムによるアクセスを提供する MCP サーバーです。標準 API を通じてサービスを提供します。現在、このサーバーは最新の階層型リソース構造を利用しており、高度なドキュメントセクションと詳細なコマンドドキュメント（サブセクションを含む）を個別の MCP リソースとして公開しています。ツールは最適化されており、多くのドキュメントクエリはリソース層で処理されます。

🚀 クイックスタート

必要条件

Python 3.13 以上がインストールされていることを確認してください（MCP SDK 互換性の最低要件は Python 3.10 です）。

リポジトリのクローン

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

仮想環境の設定と依存関係のインストール

python3.13 -m venv env
source env/bin/activate   # Windows の場合は：env\\Scripts\\activate
pip install -e .

サーバーの起動

uv run uv-docs

（Claude Desktop や他の MCP クライアントを使用する場合は、設定を適宜調整してください。）

✨ 主な機能

リンク

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

アーキテクチャ

サーバーはモジュール化および階層化された設計を採用しており、関心事を明確に分離しています。

flowchart TD
    Client[MCP クライアント] --> Server[サーバー層]
    Server --> Resources[リソース層]
    Server --> Tools[ツール層]
    Server --> Prompts[プロンプト層]
    
    Resources --> Cache[キャッシュシステム]
    Tools --> Cache

• リソース層： uv-docs:// URI スキームを使用して UV ドキュメントを提供します。リソースは階層構造で配置されています。

  • 第 1 層：基本セクション（CLI、設定、パーサーなど）
  • 第 2 層：特定のコマンドまたは設定
  • 第 3 層：詳細情報またはサブセクション

• ツール層： update_cache や search_documentation などのユーティリティツールを実装しています。

• プロンプト層： ドキュメントタスク用のプロンプトテンプレートを提供します。

キャッシュ

サーバーはバージョン感知型のキャッシュシステムを実装しています。

• 初期化：サーバー起動時に自動的にキャッシュが初期化されます。
• バージョンチェック：リアルタイムのドキュメントバージョンとキャッシュバージョンが比較されます。
• セグメントキャッシュ：各ドキュメントセクション（CLI、設定、パーサーなど）が個別にキャッシュされます。
• 手動更新：必要に応じて update_cache ツールを使用してキャッシュを更新できます。

開発

プロジェクト構造

uv-docs/
├── src/
│   └── uv_docs/
│       ├── __init__.py
│       ├── server.py         # サーバー設定とルーティング
│       ├── resources.py      # リソース処理と MCP リソースインターフェース
│       ├── cache.py          # バージョン感知型キャッシュシステム
│       ├── prompts.py        # ドキュメントタスク用のプロンプトテンプレート
│       └── tools.py          # ツールの実装（update_cache, search_documentation）
├── pyproject.toml            # プロジェクト設定
└── README.md                # プロジェクト概要（このファイル）

ビルドと公開

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 を表示します。