setup-assistant

セットアップアシスタントスキル

Claude Patent Creator MCP サーバーのインストール、設定、セットアップを行うエキスパートシステムです。

使用するタイミング

初回インストール、新しい環境のセットアップ、認証の設定、インストールのトラブルシューティング、新しいマシンへの移行、依存関係の更新、ヘルスチェックの実施時に使用します。

クイックセットアップ（5分）

# 1. Create virtual environment
python -m venv venv
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/macOS

# 2. Run installer
python install.py

# 3. Restart Claude Code

# 4. Test
# Ask Claude: "Search MPEP for claim definiteness"

セットアップの全ライフサイクル

フェーズ 1：インストール前の確認

要件：

• Python 3.9-3.12（3.11 を推奨）
• 8GB 以上の RAM（16GB を推奨）
• 5GB の空きディスク容量
• オプション：CUDA 12.x 対応の NVIDIA GPU

確認：

python --version  # Should show 3.9-3.12
nvidia-smi        # Optional: Check GPU

フェーズ 2：仮想環境

# Create venv
python -m venv venv

# Activate
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/macOS

# Verify
which python  # Should show venv path

重要： スクリプトを実行する前に、必ず venv を有効化してください。

フェーズ 3：依存関係のインストール

自動（推奨）：

python install.py
# Handles: PyTorch order, GPU detection, MCP registration

手動（上級者向け）：

# Install PyTorch FIRST (critical!)
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128

# Then install package (includes all dependencies)
pip install -e .

PyTorch のインストール順序が重要な理由： sentence-transformers の後にインストールすると、CPU 専用バージョンがインストールされます。

フェーズ 4：BigQuery 認証（オプション）

BigQuery を使うと 1 億件以上の特許を検索できますが、必須ではありません。MPEP 検索、クレームレビュー、EPO 分析、その他すべての機能は、BigQuery なしで利用できます。

セットアップ時に既存の gcloud 認証情報が自動検出されます。すでに認証済みの場合、BigQuery は自動的に利用可能になります。

後から BigQuery を有効にしたい場合：

# One command — opens browser for Google sign-in (free, no credit card)
! gcloud auth application-default login

BigQuery を失敗扱いにしたり、必須の手順として提示したりしないでください。 これは追加機能です。

フェーズ 5：MCP サーバーの登録

自動：

python install.py  # Handles registration automatically

手動：

# Get paths
patent-creator verify-config

# Register (use forward slashes!)
claude mcp add --transport stdio claude-patent-creator --scope user -- \
  "C:/path/to/venv/Scripts/python.exe" \
  "C:/path/to/mcp_server/server.py"

# Verify
claude mcp list

重要： 登録後に Claude Code を再起動してください。

フェーズ 6：設定ファイル

.env を作成します：

# Required
GOOGLE_CLOUD_PROJECT=your_project_id
ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>

# Optional
PATENT_LOG_LEVEL=INFO
PATENT_LOG_FORMAT=human
PATENT_ENABLE_METRICS=true

# Windows only
CLAUDE_CODE_GIT_BASH_PATH=C:\dev\Git\bin\bash.exe

フェーズ 7：ヘルスチェック

patent-creator health

フェーズ 8：結果の提示

MPEP インデックスが構築され、MCP サーバーが登録されればセットアップは完了です。 BigQuery と EPO OPS はオプションの拡張機能です。

準備状況を示す簡潔なサマリー表を提示してください。オプション機能について、手動セットアップの手順を大量に提示しないでください。以下の機能はすべて利用できます：

• MPEP/USC/CFR/EPC/PCT の法務検索
• クレーム分析（US + EPO）
• 明細書分析（US + EPO）
• 方式要件の確認（US + EPO + PCT）
• 特許図面の生成
• 特許出願書類の作成

BigQuery も設定されている場合は、特許検索を利用可能な機能として記載してください。設定されていない場合も失敗扱いにせず、「準備完了」リストから省くだけにしてください。

次のコマンドでテストします：

"Search MPEP for claim definiteness requirements"

これが動作すればセットアップは完了です。ユーザーに準備が整ったことを伝えてください。

よくあるセットアップの問題

問題	解決策
PyTorch が CPU 専用	まず PyTorch を再インストールする
MCP が読み込まれない	Claude Code を再起動し、claude mcp list で確認する
パスのエラー	バックスラッシュ（\）ではなくスラッシュ（/）を使う
BigQuery が失敗する	再認証する：gcloud auth application-default login
インデックスが見つからない	構築する：patent-creator rebuild-index
インポートエラー	venv を有効化する

プラットフォーム固有の注意事項

Windows

• PowerShell：venv\Scripts\activate を使います
• MCP コマンドには Git Bash が必要です
• パス：MCP 設定では常にスラッシュを使います
• CUDA：NVIDIA ドライバーとツールキットをインストールします

Linux

• venv：source venv/bin/activate
• FAISS-GPU：Linux でのみ利用できます
• 権限：sudo が必要になる場合があります

macOS

• Apple Silicon：MPS を使います（自動検出）
• Intel：CPU または外付け GPU を使います
• Homebrew：依存関係のインストールに必要な場合があります

更新とメンテナンス

依存関係の更新

venv\Scripts\activate
pip install -e . --upgrade
python scripts/test_install.py

インデックスの再構築

patent-creator rebuild-index
# Wait 5-15 minutes

MCP の再登録

claude mcp remove claude-patent-creator
python install.py
# Restart Claude Code

クイックリファレンス

必須コマンド

# Setup
python install.py
patent-creator health
claude mcp list

# Testing
python scripts/test_install.py
python scripts/test_gpu.py
python scripts/test_bigquery.py

# Maintenance
patent-creator rebuild-index
patent-creator verify-config

重要なファイル

• .env - 環境変数
• requirements.txt - 依存関係
• mcp_server/index/ - MPEP 検索インデックス
• pdfs/ - MPEP PDF ファイル