美国专利商标局最终申请决定MCP服务器

用于USPTO最终申请决定API的高性能模型上下文协议（MCP）服务器，具有令牌保存功能 上下文缩减 功能、用户自定义字段，以及 跨MCP集成 用于完整的专利生命周期分析。

![Platform Support](<>) ![Python](<>) ![API](<>) ![License: MIT](LICENSE)

📚 文档

文档	描述
📥 安装指南	使用自动化脚本完成跨平台设置
🔑 API关键指南	获取USPTO和Mistral API密钥的分步说明及屏幕截图
📖 使用示例	功能示例、工作流和集成模式
🎯 提示模板	法律和研究工作流程复杂提示模板的详细指南
⚙️ 现场定制	为最小和平衡的工具定制字段集的全面指导
🔒 安全指南	全面的安全最佳实践
🛡️ 安全扫描	自动秘密检测和预防指南
🧪 测试指导	测试套件文档和API密钥设置
⚖️ 许可证	MIT许可条款和条件

⚡快速开始

Windows安装

以管理员身份运行PowerShell那么：

# Navigate to your user profile
cd $env:USERPROFILE

# If git is installed:
git clone https://github.com/john-walkoe/uspto_fpd_mcp.git
cd uspto_fpd_mcp

# If git is NOT installed:
# Download and extract the repository to C:\Users\YOUR_USERNAME\uspto_fpd_mcp
# Then navigate to the folder:
# cd C:\Users\YOUR_USERNAME\uspto_fpd_mcp

# The script detects if uv is installed and if it is not it will install uv - https://docs.astral.sh/uv

# Run setup script (sets execution policy for this session only):
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process
.\deploy\windows_setup.ps1

## View INSTALL.md for sample script output.
# Close Powershell Window.
# If choose option to "configure Claude Desktop integration" during the script then restart Claude Desktop

PowerShell脚本将：

✅ 检查并自动安装uv（通过winget或PowerShell脚本）
✅ 安装依赖项并创建可执行文件
✅ 提示输入USPTO API密钥（必需）和Mistral API密钥（可选）或检测是否已安装开发人员的其他USPTO MCP，并询问是否要使用这些安装中的现有密钥。
🔒 如果输入API密钥，脚本将自动使用Windows DPAPI加密安全地存储API密钥
✅ 问你有没有 USPTO PFW MCP 已安装，如果是这样，将使用USPTO PFW MCP的默认集中式代理
✅ 询问是否要配置Claude Desktop集成
🔒 提供安全的配置方法（推荐）或传统方法（MCP JSON文件中的纯文本API密钥）
✅ 备份，然后自动与现有的Claude Desktop配置合并（保留其他MCP服务器）
✅ 提供安装摘要和后续步骤

Claude桌面配置-手动安装

{
  "mcpServers": {
    "uspto_fpd": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/Users/YOUR_USERNAME/uspto_fpd_mcp",
        "run",
        "fpd-mcp"
      ],
      "env": {
        "USPTO_API_KEY": "your_actual_USPTO_api_key_here",
        "MISTRAL_API_KEY": "your_mistral_api_key_here_OPTIONAL",
        "CENTRALIZED_PROXY_PORT": "none",
        "FPD_PROXY_PORT": "8081"
      }
    }
  }
}

代理配置说明：

集中式代理端口:

- 设置为 "none" 独立使用（不推荐） - 当安装了USPTO PFW MCP并且PFW使用其默认端口作为本地代理时，设置为8080。（如果PFW未使用其默认端口，请更改此值以匹配）

FPD_PROXY_PORT：本地代理端口（默认值： 8081，避免与PFW发生冲突 8080)

- 仅在独立模式下使用（未检测到PFW MCP） - 安装PFW MCP后，FPD会自动使用PFW的集中式代理（端口 8080)，但将回退到FPD的本地代理端口 - 集中式代理的好处：所有USPTO MCP的单端口，7天持久链路，统一速率限制

🔑 主要特点

⚙️用户可自定义字段 -通过YAML配置字段集，无需更改代码
🎯上下文缩减 -获得集中的响应，而不是大规模的API转储（减少80-99%）
📊渐进式披露策略 -最小发现→ 平衡分析→ 文档提取
🔍请愿类型重点搜索 -用于艺术单元和特定应用搜索的专用工具
✨智能文档提取 -自动优化混合提取（免费PyPDF2→ Mistral OCR回退）和安全的浏览器下载
🆕集中式代理集成 -自动检测PFW MCP，并使用统一代理（端口8080）进行持久链接和跨MCP下载
🌐安全浏览器下载 -单击代理URL可直接下载PDF，同时确保API密钥的安全
👁️高级OCR功能 -需要时使用Mistral OCR从扫描的PDF中提取文本
📁 文件袋集成 -完整的请愿文件访问权限以及结构化的请愿数据
💰Mistral OCR成本透明度 -使用Mistral OCR时的实时成本计算
🔐 安全的API密钥存储 -可选的Windows DPAPI加密可确保API密钥的安全（配置文件中没有纯文本）
🚀高性能 -具有指数回退和速率限制合规性的重试逻辑
🛡️ 生产就绪 -增强的错误处理、带请求ID的结构化日志记录、全面的安全指南
💻交叉平台的 -在Linux和Windows上无缝工作
📋API全面覆盖 -支持所有USPTO最终申请决定端点
🔗跨MCP集成 -与专利文件包装器和PTAB MCP无缝集成，实现完整的生命周期分析

工作流设计-所有工作均由LLM在最少的用户指导下完成

用户请求如下：

*“查找TechCorp提交的所有请愿书，并告诉我任何危险信号”*
*“给我看看2128艺术单元的复兴请愿书——我正在分析遗弃模式”*
*“给我申请17414168的请愿历史记录”*
*“从上访频率和类型分析该艺术单位的起诉质量”*

LLM执行以下步骤：

第一步：发现（最小） → 第二步：选择和分析（平衡-可选） → 第三步：详细的请愿书审查 → 步骤4（可选）：选择特定的请愿文件进行审查 → 步骤5（可选）：从documentBag中检索document_id → 步骤6（可选）：用于LLM的文档提取和/或用户使用的PDF下载链接

现场配置支持优化的研究进展：

发现（最小） 高效地返回50-100份请愿书，而不会造成文件膨胀
选择和分析（平衡-可选） 从检索到的可能请愿书中选择。如果需要，在高级工作流和/或具有专利文件包装器或PTAB的跨MCP工作流中执行可选的平衡搜索
详细的请愿书审查 通过 fpd_get_petition_details 适用于具有完整结构化数据的选定请愿书，供法学硕士用于分析
选择特定的请愿文件进行审查 （可选）例如决定书、请愿书、支持证据
从documentBag中检索document_id （可选）使用 fpd_get_petition_details 随着 include_documents=True 获取document_id
LLM使用的文档提取和/或下载链接 （可选）通过自动优化成本和质量的智能混合工具提取文档，并在PDF使用HTTP代理的URL时下载文档，该代理会从聊天历史记录中屏蔽USPTO的API密钥

🎯 提示模板

此MCP服务器包括用于复杂请愿工作流的复杂AI优化提示模板。有关所有模板、功能和使用示例的详细文档，请参阅 PROMPTS.md.

快速模板概述

类别	模板	目的
法律分析	`/company_petition_risk_assessment_PFW`, `/patent_vulnerability_assessment_ptab`, `/litigation_research_setup_pfw`	尽职调查、PTAB风险评估、诉讼准备
研究与起诉	`/art_unit_quality_assessment`, `/prosecution_quality_correlation_pfw`, `/revival_petition_analysis`	艺术单元分析、考官行为、放弃模式
文档管理	`/petition_document_research_package`, `/complete_portfolio_due_diligence_pfw_ptab`	有组织的检索，全面的生命周期分析

所有模板的主要功能：

增强的输入处理 -灵活的标识符支持（申请ID、申请号、公司名称）
智能验证 -自动格式检测和引导
跨MCP集成 -使用PFW、PTAB和引文MCP实现无缝工作流程
上下文优化 -通过逐步披露减少代币

📊 可用功能

搜索功能（4个重点工具）

函数（显示名称）	上下文缩减	用例
`fpd_search_petitions_minimal` （搜索请求最少）	典型的95-99%	超快速的请求发现（用户可自定义的最小字段）
`fpd_search_petitions_balanced` （搜索请愿书平衡）	典型80-88%	详细分析的关键字段（无documentBag）
`fpd_search_petitions_by_art_unit` （按艺术单位搜索请愿书）	典型80-88%	带日期范围过滤的艺术单位质量评估
`fpd_search_petitions_by_application` （按申请搜索请愿书）	典型80-88%	特定申请的完整请愿历史记录

搜索策略

专业搜索策略

艺术单元质量评估 -使用 fpd_search_petitions_by_art_unit 分析艺术单位对考官行为和技术难度评估的请愿模式
申请请愿历史 -使用 fpd_search_petitions_by_application 在起诉期间获得特定申请的完整请愿时间表
跨MCP集成 -使用以下方式将请愿数据与PFW起诉历史联系起来 applicationNumberText PTAB挑战 patentNumber
红旗标识 -重点关注恢复申请（《联邦法规》第37篇第1.137节）、审查员争议（《联邦法典》第37章第1.181节）和被驳回的起诉质量分析决定

查询示例

# Art unit quality assessment
fpd_search_petitions_by_art_unit(
    art_unit="2128",
    date_range="2020-01-01:2024-12-31",
    limit=100
)

# Complete application petition history
fpd_search_petitions_by_application(
    application_number="17896175",
    include_documents=False
)

# Cross-MCP workflow example
# 1. Find applications with PFW
# 2. Check petition history for red flags
fpd_search_petitions_by_application(
    application_number=app_from_pfw,
    include_documents=True
)

文档处理功能

功能（显示名称）	用途	要求
`fpd_get_petition_details` （获取申请详细信息）	按UUID列出的完整申请详细信息，并附带可选文档Bag	USPTO_API_KEY
`fpd_get_document_content` （FPD获取文档内容）	具有成本透明性的智能文档提取	USPTO_API_KEY（+MISTRAL_API_KEY用于OCR回退）
`fpd_get_document_download` （FPD获取文档下载）	安全浏览器可访问的下载URL	USPTO_API_KEY

文档处理能力

请愿详细信息级别(fpd_get_petition_details)：完成请愿书数据检索

- 基于UUID的查找 -通过唯一标识符查找请愿书 - 可选文件袋 -根据需要包括/排除文档 - LLM优化解析 -摘录问题、引用的规则、法规、决定细节 - 交叉引用字段 -applicationNumber文本、专利号、组ArtUnitNumber用于跨MCP工作流

智能提取层(fpd_get_document_content)：混合自动优化提取

- 智能方法选择 -自动首先尝试PyPDF2（免费），需要时返回到Mistral OCR（需要API密钥） - 成本优化 -仅在PyPDF2提取未通过质量检查时支付OCR费用 - 质量检测 -自动确定提取是否可用或是否需要OCR - 透明的报告 -显示使用了哪种方法和相关成本 - 统一接口 -单一工具可处理所有文档类型（消除工具混淆） - 高性能 -使用Mistral OCR从扫描文档中提取文本 - 成本 -基于文本的PDF免费，使用Mistral扫描OCR每页约0.001美元

浏览器下载层(fpd_get_document_download)：使用增强的文件名进行安全代理下载

- 点击下载 直接在任何浏览器中工作的URL - 集中式代理集成 -如果已设置，自动检测PFW MCP，并对所有USPTO文档下载使用统一代理（端口8080），如果检测到集中式代理的问题，将回退到本地代理。 - 持久链接 -使用PFW集中式代理时的7天加密链接（跨MCP重启工作） - 统一架构 -安装PFW时，所有USPTO MCP的单个HTTP代理（端口8080） - 独立回退 -未检测到PFW时的本地代理（端口8081） - 增强的文件名 -带有申请日期、申请/专利号和描述的专业格式 - 格式： PET-2013-09-10_APP-13632078_PAT-8803593_PATENT_PROSECUTION_HIGHWAY_DECISION.pdf - 按请愿书提交日期按时间顺序排序 - 专利律师和文件管理的即时上下文 - API密钥安全 -USPTO凭据从未在聊天记录或浏览器中公开 - 速率限制合规性 -自动执行美国专利商标局每10秒5次下载

LLM指导功能

功能（显示名称）	用途	要求
`FPD_get_guidance` （FPD获得指导）	上下文高效分段LLM指导（80-95%的令牌减少）	无

#### 情境高效引导系统

新 fpd_get_guidance 工具 -通过选择性指导部分解决MCP资源可见性问题：

🎯 快速参考图 -你的问题在哪个部分？

🔍 “按公司/艺术单位查找请愿书”→ tools

🚩 “识别请愿红旗”→ 红色标签

📄 “下载请愿文件”→ 文件

🤝 “将请愿与起诉联系起来”→ 工作流\_ pfw

⚖️ “分析请愿书+PTAB模式”→ 工作流程_ptab

📊 “引文质量+请愿书相关性”→ 工作流程_引用

🏢 “完整的投资组合尽职调查”→ 工作流_完成

📚 “与助手一起研究CFR规则”→ 工作流程_助理

🎯 “超低PFW+FPD工作流程”→ 超文本

💰 “降低提取成本”→ cost

该工具提供了特定的工作流程、现场建议、API调用优化策略、要避免的反模式以及最大效率的跨MCP集成模式。看用法_示例.md 查看详细示例和集成工作流程。

💻 使用示例和集成工作流

有关综合使用示例，包括：

基本请愿搜索 （公司、类型、结果）
艺术单元质量评估 （请愿频率、类型、审查员争议）
申请请愿历史 （完整的生命周期跟踪）
跨MCP集成工作流程 （FPD+PFW+PTAB+Pinecone）
红旗标识 （恢复请愿书、审查员争议、被驳回的请愿书）
文档提取和下载 （混合PyPDF2/OCR方法）
成本优化策略

查看详情用法_示例.md 文档。

🔧 现场定制

MCP服务器通过YAML配置支持用户自定义字段集，以实现最佳的上下文缩减。您可以在不更改任何代码的情况下修改字段集！

配置文件： field_configs.yaml （以项目根为单位）

有关完整的定制指导，包括渐进式工作流策略、令牌优化和高级字段选择模式，请参阅 定制.md.

🔗 跨MCP集成

该MCP旨在与其他USPTO MCP和知识库无缝协作，以进行全面的专利生命周期分析：

集成概述

这 最终请愿决定（FPD）MCP 弥合起诉和批准后的挑战，跟踪揭示起诉质量问题的程序性请愿。当与其他MCP结合使用时，它能够：

FPD+PFW：通过与起诉历史的交叉引用了解请愿书背景
FPD+PFW+增强引用：将请愿模式与审查员引用质量相关联，以进行全面的起诉评估（2017年10月+申请）
FPD+PTAB：将请愿危险信号与拨款后的挑战结果联系起来
PFW+FPD+PTAB：完成从申请到授权后挑战的专利生命周期跟踪
PFW+FPD+增强引用：引用情报和请愿模式分析的艺术单位质量评估
FPD+松果（助理或RAG）：在提取昂贵的文件之前，研究MPEP指南和请愿标准

关键集成模式

交叉引用字段：

applicationNumberText -将请愿书与PFW起诉联系起来的主键和增强引用
patentNumber -二级密钥将已授予的专利与PTAB挑战联系起来
groupArtUnitNumber -所有MCP（FPD、PFW、增强引用、PTAB）的艺术单元分析
firstApplicantName -跨MCP的派对匹配
examinerCitedReferenceIndicator （引文MCP）-审查员与申请人引文分析请愿书质量相关性

渐进式工作流程：

发现（FPD）：使用最小搜索查找请愿书
起诉背景 （PFW）：将请愿申请与起诉历史进行交叉引用
引文情报 （增强引用）：分析有请愿书的申请的审查员引用质量（仅2017年10月以上）
挑战评估 （PTAB）：检查有申请危险信号的专利是否面临授权后的挑战
知识研究 （RAG）：研究MPEP请愿指南（如有）
详细分析 （FPD）：摘录请愿文件供主任推理
风险评分：根据请愿模式、引用质量和结果量化起诉质量

有关详细的集成工作流、交叉引用示例和完整用例，请参阅用法_示例.md.

🆕集中式代理集成（PFW+FPD）

当安装了PFW和FPD MCP时，FPD会自动与PFW的集中式代理集成，以实现统一的文档管理：

架构优势：

单端口 -一个HTTP服务器（端口8080）用于所有USPTO文档下载
持久链接 -通过PFW的SQLite数据库进行7天加密链接（跨MCP重启工作）
统一速率限制 -所有MCP共享USPTO限制（5个请求/10秒）
跨MCP缓存 -PFW缓存来自所有USPTO MCP的文档，以实现更快的访问
自动检测 -FPD在启动时检测PFW并切换到集中模式

工作原理：

FPD从USPTO API响应中提取PDF下载URL
FPD生成增强的文件名： PET-{date}_APP-{app}_PAT-{patent}_{description}.pdf
FPD向PFW登记文件： POST /register-fpd-document （包括增强的文件名）
PFW将元数据存储在数据库中（petition_id、download_url、api_key、enhanced_filename）
FPD返回下载链接： http://localhost:8080/download/{petition_id}/{doc_id}
用户点击链接→ PFW从美国专利商标局获取→ 使用增强的文件名流式传输PDF
链接将持续7天，并在MCP重启后正常工作

独立模式：

没有PFW:FPD使用本地代理（端口8081）进行基于会话的即时下载
增强的文件名仍然有效（本地使用的生成逻辑相同）
优雅的回退确保FPD独立工作，具有完整的文件名功能

📈 性能比较

方法	响应大小	上下文用法	功能
直接卷曲	约100KB+	高	原始API访问
MCP平衡	~10KB	中等	分析关键字段
MCP最小值	~2KB	非常低	仅基本数据

🧪 测试

核心测试（基本）

紫外线（推荐）：

# Test core functionality and field configuration
uv run python tests/test_basic.py

# Expected: ALL TESTS PASSED!

使用传统Python：

python tests/test_basic.py

预期产出

test_basic.py：

[OK] Settings imported successfully
[OK] FieldManager imported successfully
[OK] FPDClient initialized successfully
ALL TESTS PASSED!

看测试/README.md 获取全面的测试指南。

📁 项目结构

uspto_fpd_mcp/
├── field_configs.yaml             # Root-level field customization
├── .security/                      # Security scanning components
│   ├── fpd_prompt_injection_detector.py # Enhanced prompt injection detection
│   └── check_prompt_injections.py # Standalone scanning script
├── src/
│   └── fpd_mcp/
│       ├── main.py                 # MCP server with 8 tools
│       ├── __main__.py            # Entry point for -m execution
│       ├── secure_storage.py       # Windows DPAPI secure storage
│       ├── shared_secure_storage.py
│       ├── config/
│       │   ├── field_manager.py   # Configuration management
│       │   ├── settings.py        # Environment configuration
│       │   ├── tool_reflections.py # Sectioned LLM guidance (11 sections, 80-95% token reduction)
│       │   ├── api_constants.py   # API configuration constants
│       │   ├── api_key_validation.py
│       │   └── storage_paths.py    # Storage path management
│       ├── prompts/
│       │   ├── __init__.py        # Prompt registration
│       │   ├── company_petition_risk_assessment_pfw.py
│       │   ├── art_unit_quality_assessment.py
│       │   ├── revival_petition_analysis.py
│       │   ├── petition_document_research_package.py
│       │   ├── complete_portfolio_due_diligence_pfw_ptab.py
│       │   ├── litigation_research_setup_pfw.py
│       │   ├── prosecution_quality_correlation_pfw.py
│       │   ├── patent_vulnerability_assessment_ptab.py
│       │   ├── petition_quality_with_citation_intelligence.py
│       │   └── examiner_dispute_citation_analysis.py
│       ├── api/
│       │   ├── fpd_client.py      # FPD API client
│       │   └── field_constants.py # Field name constants
│       ├── proxy/
│       │   ├── server.py          # HTTP proxy for secure downloads
│       │   └── rate_limiter.py    # USPTO rate limiting compliance
│       ├── shared/
│       │   ├── error_utils.py     # Error handling utilities
│       │   ├── circuit_breaker.py # Circuit breaker pattern
│       │   ├── internal_auth.py   # Internal authentication
│       │   ├── structured_logging.py
│       │   └── security_logger.py # Security event logging
│       ├── services/
│       │   └── fpd_service.py     # Core business logic layer
│       ├── monitoring/
│       │   └── metrics.py         # Performance monitoring
│       └── util/
│           ├── logging.py         # Enhanced logging utilities
│           └── secure_logger.py   # Secure logging functionality
├── deploy/
│   ├── linux_setup.sh            # Linux deployment script
│   ├── windows_setup.ps1         # PowerShell deployment script
│   ├── manage_api_keys.ps1       # API key management utilities
│   ├── Validation-Helpers.psm1   # PowerShell validation module
│   └── Validation-Helpers.sh     # Bash validation helpers
├── tests/
│   ├── test_basic.py             # Core functionality test
│   ├── test_integration.py       # Integration tests
│   ├── test_tiered_convenience_params.py
│   ├── test_unified_key_management.py
│   ├── test_unified_storage.py
│   ├── validate_convenience_params_implementation.py
│   └── README.md                 # Testing documentation
├── reference/
│   ├── Document_Descriptions_List.csv
│   ├── FinalPetitionDecisions_swagger.yaml
│   ├── petition-decision-schema.json
│   └── README.md
├── documentation_photos/          # Visual documentation
│   ├── Prompts-Step1.jpg         # Prompt template usage guides
│   ├── Prompts-Step2.jpg
│   ├── Prompts-Step3.jpg
│   ├── Prompts-Step4.jpg
│   ├── Prompts-Step5.jpg
│   └── n8n_FPD.jpg               # N8N integration example
├── pyproject.toml                 # Package configuration
├── README.md                      # This file
├── INSTALL.md                     # Comprehensive installation guide
├── USAGE_EXAMPLES.md             # Function examples and workflows
├── CUSTOMIZATION.md              # Field configuration and optimization guide
├── PROMPTS.md                    # Prompt templates documentation
├── SECURITY_GUIDELINES.md        # Security best practices
├── SECURITY_SCANNING.md          # Automated secret detection guide
└── LICENSE                       # MIT License

🔍 故障排除

常见问题

API关键问题

对于Claude Desktop： 配置文件中的API密钥足够
对于测试脚本： 必须设置环境变量

正在设置USPTO API密钥：

Windows命令提示符： set USPTO_API_KEY=your_key
Windows PowerShell： $env:USPTO_API_KEY="your_key"
Linux/macOS： export USPTO_API_KEY=your_key

设置Mistral API密钥（用于OCR）：

Windows命令提示符： set MISTRAL_API_KEY=your_key
Windows PowerShell： $env:MISTRAL_API_KEY="your_key"
Linux/macOS： export MISTRAL_API_KEY=your_key

uv与pip问题

紫外线优势： 更好的依赖关系解决方案，更快的安装
混合安装： 两者都可以使用 uv sync 和 pip install -e .
测试： 使用 uv run uv管理项目的前缀

不返回数据的字段

原因： 字段名不在YAML配置中
解决方案： 编辑 field_configs.yaml 包含所需字段

身份验证错误

原因： API密钥丢失或无效
解决方案： 验证 USPTO_API_KEY 环境变量或Claude Desktop配置

MCP服务器无法启动

原因： 缺少依赖关系或路径不正确
解决方案： 重新运行安装脚本，重新启动所有PowerShell窗口，重新启动Claude Desktop（或其他MCP客户端）并验证配置
如果问题仍然存在： 重置MCP安装（请参阅下面的“重置MCP安装”）

虚拟环境问题（Windows安装程序）

症状： 期间出现“无pyvenv.cfg文件”错误 windows_setup.ps1
原因： 克劳德桌面锁 .venv 运行时文件，阻止正确创建虚拟环境
解决方案：

1. 在运行安装脚本之前完全关闭Claude Desktop 1. 移除 .venv 文件夹： Remove-Item ./.venv -Force -Recurse -ErrorAction SilentlyContinue 1. 跑 .\deploy\windows_setup.ps1 再次

重置MCP安装

如果您需要完全重置MCP安装以再次运行Windows快速安装程序：

# Navigate to the project directory
cd C:\Users\YOUR_USERNAME\uspto_fpd_mcp

# Remove Python cache directories
Get-ChildItem -Path ./src -Directory -Recurse -Force | Where-Object { $_.Name -eq '__pycache__' } | Remove-Item -Recurse -Force

# Remove virtual environment
if (Test-Path ".venv") {
    Remove-Item ./.venv -Force -Recurse -ErrorAction SilentlyContinue
}

# Remove database files (if any)
Remove-Item ./proxy_documents.db -Force -ErrorAction SilentlyContinue
Remove-Item ./petition_links.db -Force -ErrorAction SilentlyContinue

# Now you can run the setup script again
.\deploy\windows_setup.ps1

Linux/macOS重置：

# Navigate to the project directory
cd ~/uspto_fpd_mcp

# Remove Python cache directories
find ./src -type d -name '__pycache__' -exec rm -rf {} + 2>/dev/null || true

# Remove virtual environment and database files
rm -rf .venv
rm -f proxy_documents.db petition_links.db

# Run setup script again
./deploy/linux_setup.sh

获取帮助

检查测试脚本中的工作示例
查看中的字段配置 field_configs.yaml
验证您的Claude Desktop配置是否与INSTALL.md中提供的模板匹配

🛡️ 安全和生产准备

增强的错误处理

使用指数回退重试逻辑 -瞬时故障的自动重试（3次尝试，延迟1秒、2秒、4秒）
智能重试策略 -不重试身份验证错误或客户端错误（4xx）
结构化日志 -请求ID跟踪以更好地调试和监控
生产级弹性 -妥善处理超时、网络问题和API速率限制
可配置超时 -API请求调整的USPTO_IMEOUT和USPTO_DOWNLOAD_IMEOUT环境变量

安全特性

🔐 Windows DPAPI安全存储 -使用Windows Data Protection API加密的API密钥（用户特定加密）
🛡️ 自动消毒的安全记录 -所有日志记录自动屏蔽API密钥、令牌和敏感数据；基于文件的审计跟踪，可轮换 ~/.uspto_fpd_mcp/logs/
环境变量API键 -代码库中任何地方都没有硬编码的凭据
零个纯文本API键 -安全存储选项消除了Claude Desktop配置文件中的API密钥
跨平台安全 -在非Windows系统上自动回退到环境变量
安全测试模式 -测试文件使用带有回退的环境变量
综合.gitignore -防止意外提交凭据
安全指南 -安全开发实践的完整文档
自动秘密扫描 -CI/CD和预提交挂钩可防止API密钥泄漏（检测secrets）
检测到20+种秘密类型 -AWS密钥、GitHub令牌、JWT、私钥、API密钥等
快速注射检测 -70+模式检测系统可抵御AI特定攻击
基线管理 -追踪已知占位符，同时捕捉真正的秘密
字段名称常量 -消除魔术串，减少基于拼写错误的安全问题

请求跟踪和调试

所有API请求都包含用于关联的唯一请求ID（8个字符的UUID）：

[a1b2c3d4] Starting GET request to petition/decisions/search
[a1b2c3d4] Request successful on attempt 1

文档

SECURITY_GUIDELINES.md -全面的安全最佳实践
SECURITY_SCANNING.md -自动秘密检测和预防指南
tests/README.md -API密钥设置的完整测试指南
带有请求ID的增强错误消息，以获得更好的支持

📝 贡献

分叉存储库
创建要素分支
添加新功能的测试
确保所有测试通过
提交拉取请求

📄 许可证

MIT许可证

⚠️ 免责声明

本软件按“原样”提供，不提供任何形式的保修。

独立项目通知：这是一个独立的个人项目，不隶属于美国专利商标局（USPTO），也不受其认可或赞助。

作者不作任何明示或暗示的陈述或保证，包括但不限于：

准确性和人工智能生成的内容：不保证数据的准确性、完整性或适用于任何目的。特别提醒用户，人工智能（AI）组件生成或辅助的输出，包括但不限于文本、数据或分析，可能不准确、不完整、虚构，或代表AI模型的“幻觉”（虚构）。
可用性：USPTO API和Mistral API依赖关系可能会导致服务中断。
法律合规用户全权负责确保其对本软件的使用，以及基于其输出所做的任何提交或操作，严格遵守所有适用的法律、法规和政策，包括但不限于：

- 最新的美国专利商标局关于人工智能工具在实践中的使用指南（美国专利商标局指南）。 - 美国专利商标局的坦诚和诚信义务（例如，《美国联邦法规》第37篇第1.56、11.303节），其中包括披露重要信息和纠正错误的义务。 - 美国专利商标局的签名要求（例如，37 CFR 1.4（d）、2.193（c）、11.18），证明人工审查和合理询问。 - 所有关于发明权的规则（例如，每项要求保护的发明必须至少有一名人类发明人）。

法律咨询：此工具仅提供数据访问和处理，不提供法律顾问。所有结果必须由合格的法律专业人员独立验证、批判性分析和专业判断。
商业用途：用户必须验证USPTO和Mistral的商业应用条款。
保密和数据安全：作者对用户输入软件人工智能组件或传输给第三方人工智能服务（如Mistral API）的任何数据（包括客户敏感或技术信息）的机密性或安全性不作任何陈述。用户有责任理解和接受任何集成的第三方人工智能服务的隐私政策、数据保留做法和安全措施。
外国备案许可证和出口管制用户全权负责确保通过本软件的人工智能组件输入或处理任何数据，特别是技术信息，不违反美国外国申请许可证要求（例如，35 U.s.C.184、37 CFR第5部分）或出口管制法规（例如，EAR、ITAR）。这包括如果外国人访问此类数据或人工智能服务器位于美国境外，则应意识到潜在的“视为出口”。

责任限制： 在任何情况下，作者均不对因使用本软件而产生的任何直接、间接、附带、特殊或后果性损害承担责任，即使已被告知此类损害的可能性。

用户责任：您对USPTO之前提交的所有文件和采取的行动的完整性和合规性负全部责任。

独立验证：在依赖、采取行动或提交给美国专利商标局或任何其他实体之前，本软件中人工智能生成或协助的所有输出、分析和内容都必须经过彻底审查、独立验证和纠正。这包括事实陈述、法律争论、引用、证据支持和技术披露。
诚实守信的义务：您必须遵守与美国专利商标局坦诚相待的义务，包括披露任何重要信息（例如，关于发明或错误），并及时纠正记录中的任何不准确之处。
签名与认证：根据《美国联邦法规》第37篇第11.18（b）条的要求，您必须亲自在提交给美国专利商标局的任何信件上签名或插入您的签名，证明您对其内容的个人审查和合理查询。人工智能工具不能签署文件，也不能执行所需的人工查询。
机密信息：未经客户完全同意并清楚了解底层人工智能提供商的数据处理实践，不得将机密、专有或客户敏感信息输入本软件的人工智能组件。您有责任防止无意或未经授权的披露。
出口管制：在使用此工具处理敏感技术数据时，请注意并遵守所有外国备案许可证和出口管制规定。
服务合规性：确保遵守所有USPTO（例如，USPTO网站的使用条款、USPTO.gov帐户政策、对自动数据挖掘的限制）和Mistral服务条款。人工智能工具无法获取USPTO.gov帐户。
安全：维护API凭证和客户端信息的安全处理。
测试：在生产使用前进行彻底测试。
专业判断：此工具是对您自己的专业判断和专业知识的补充，而不是替代。

使用本软件即表示您承认已阅读本免责声明，并同意自行承担使用该软件的风险，对所有结果承担全部责任，并遵守相关的法律和道德义务。

法律专业人士须知： 虽然该工具提供了对法律实践中常用的专利研究工具的访问，但它只是一个数据检索和人工智能辅助处理系统。所有结果都需要独立验证、关键的专业分析，不能替代合格的法律顾问或美国专利商标局人工智能使用指南中概述的个人专业判断和职责的行使。

🔗 相关链接

💝 支持这个项目

如果您发现此USPTO最终申请决定MCP服务器有用，请考虑支持开发！这个项目是在我个人时间里开发的，耗时数小时，为专利界提供了一个全面的、可生产的工具。

![Donate with PayPal](https://paypal.me/walkoe)

您的支持有助于为专利界的每个人维护和改进这个开源工具。非常感谢。

致谢

美国专利商标局提供API的最终申请决定
模型上下文协议对于MCP规范
克劳德代码 在整个项目中提供卓越的开发协助、架构指导、文档创建、PowerShell自动化、测试组织和全面的代码开发
克劳德桌面版 获取额外的开发支持和测试协助

______________________________________________________________________

问题？ 看安装.md 获取完整的跨平台安装指南，或查看工作示例的测试脚本。

MCP服务器	用途	GitHub存储库
美国专利商标局专利文件包装（PFW）	起诉历史和文件	uspto_pfw_mcp
美国专利商标局最终申请决定（FPD）	起诉期间的请愿决定	uspto_fpd_mcp
美国专利商标局增强引用	人工智能从2017年10月至今邮寄的Office Actions中提取引文情报（应用程序于2015+提交）	uspto_enriched_citation_mcp
美国专利商标局专利审判和上诉委员会（PTAB）	赠款后的挑战	uspto_ptab_mcp
松果辅助MCP	专利法知识库，带AI聊天和引用（MPEP，考试指南）-1 API密钥，有限免费等级	松果体_助剂_mcp
松果RAG MCP	带有自定义嵌入的专利法知识库（MPEP，考试指导）-需要松果+嵌入模型，每月重置免费等级	松果_拉格_mcp

USPTO Final Petition Decisions MCP Server

快速接入

详细介绍