SuperAPI AI 工具集

setup-assistant

编程与开发

查看项目

更新于 10-16 01:56

技能介绍

Setup Assistant 是 Claude Patent Creator 系统的安装与配置专家技能,负责引导完成该 MCP 服务器的安装、配置和首次设置。

一、用途与使用时机 该技能用于:首次安装、在新环境搭建、配置认证、排查安装问题、迁移到新机器、更新依赖以及验证系统健康状态。

二、快速设置(约 5 分钟)

  1. 创建虚拟环境:python -m venv venv,随后在 Windows 执行 venv\Scripts\activate,在 Linux/macOS 执行 source venv/bin/activate。
  2. 运行安装程序:python install.py。
  3. 重启 Claude Code。
  4. 测试:向 Claude 提问“Search MPEP for claim definiteness”。

三、完整设置流程 阶段 1 安装前检查:要求 Python 3.9-3.12(推荐 3.11)、8GB 以上内存(推荐 16GB)、5GB 可用磁盘,可选 NVIDIA GPU 与 CUDA 12.x。使用 python --version 验证版本,使用 nvidia-smi 可选检查 GPU。

阶段 2 虚拟环境:创建并激活 venv,用 which python 确认路径。注意运行脚本前必须先激活 venv。

阶段 3 依赖安装:推荐自动化方式 python install.py,会处理 PyTorch 安装顺序、GPU 检测与 MCP 注册。手动方式需先安装 PyTorch(pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128),再执行 pip install -e .。顺序很重要:若在 sentence-transformers 之后安装 PyTorch,会得到仅 CPU 版本。

阶段 4 BigQuery 认证(可选):BigQuery 增加 1 亿以上专利检索,但非必需;MPEP 检索、权利要求审查、EPO 分析等功能无需它即可使用。设置会自动检测现有 gcloud 凭据;若已认证则 BigQuery 自动可用。后续如需启用,可执行 gcloud auth application-default login(一条命令,打开浏览器进行 Google 登录,免费、无需信用卡)。不应将 BigQuery 呈现为失败或必需步骤,它属于附加功能。

阶段 5 MCP 服务器注册:自动化由 python install.py 处理;手动方式先用 patent-creator verify-config 获取路径,再注册:claude mcp add --transport stdio claude-patent-creator --scope user -- "C:/path/to/venv/Scripts/python.exe" "C:/path/to/mcp_server/server.py",然后用 claude mcp list 验证。注册后必须重启 Claude Code。

阶段 6 配置文件:创建 .env,必填 GOOGLE_CLOUD_PROJECT 与 ANTHROPIC_API_KEY;可选 PATENT_LOG_LEVEL=INFO、PATENT_LOG_FORMAT=human、PATENT_ENABLE_METRICS=true;Windows 专用 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,执行 pip install -e . --upgrade,再运行 python scripts/test_install.py。重建索引:patent-creator rebuild-index,等待 5-15 分钟。重新注册 MCP:claude mcp remove claude-patent-creator,运行 python install.py,重启 Claude Code。

七、快速参考 常用命令:设置用 python install.py、patent-creator health、claude mcp list;测试用 python scripts/test_install.py、python scripts/test_gpu.py、python scripts/test_bigquery.py;维护用 patent-creator rebuild-index、patent-creator verify-config。关键文件:.env(环境变量)、requirements.txt(依赖)、mcp_server/index/(MPEP 检索索引)、pdfs/(MPEP PDF 文件)。

八、限制 该技能聚焦于安装与配置流程,未提供超出上述内容的系统功能细节。具体收费、价格与效果信息暂未提供。