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 文件