MCP KIPRIS

KIPRIS（韩国专利信息院）API支持的专利搜索工具。

功能

韩国专利搜索

1. 申请人搜索 (PatentApplicantSearchTool)

   • 按申请人名称搜索专利
   • 支持排序和过滤选项

2. 关键词搜索 (PatentFreeSearchTool)

   • 使用自由文本搜索专利
   • 支持排序和过滤选项

3. 申请号搜索 (PatentApplicationNumberSearchTool)

   • 按申请号搜索专利
   • 可查询详细信息

4. 权利人搜索 (PatentRighterSearchTool)

   • 按权利人名称搜索专利
   • 支持排序和过滤选项

5. 专利详细信息搜索 (PatentDetailSearchTool)

   • 按申请号查询专利的详细信息

6. 专利概要信息搜索 (PatentSummarySearchTool)

   • 按申请号查询专利的概要信息

海外专利搜索

1. 申请人搜索 (ForeignPatentApplicantSearchTool)

   • 按申请人名称搜索海外专利
   • 支持按国家搜索

2. 申请号搜索 (ForeignPatentApplicationNumberSearchTool)

   • 按申请号搜索海外专利
   • 支持按国家搜索

3. 关键词搜索 (ForeignPatentFreeSearchTool)

   • 使用自由文本搜索海外专利
   • 支持按国家搜索

4. 国际申请号搜索 (ForeignPatentInternationalApplicationNumberSearchTool)

   • 按国际申请号搜索海外专利

5. 国际公开号搜索 (ForeignPatentInternationalOpenNumberSearchTool)

   • 按国际公开号搜索海外专利

安装及运行

环境设置

1. 设置KIPRIS API密钥

export KIPRIS_API_KEY="your_api_key"

2. 安装依赖项

pip install -r requirements.txt

运行方法

1. HTTP服务器模式

python -m mcp_kipris.sse_server --http --port 6274 --host 0.0.0.0

2. stdio服务器模式

python -m mcp_kipris.server

支持的国家代码

• US: 美国
• EP: 欧洲
• WO: PCT
• JP: 日本
• PJ: 日本英文摘要
• CP: 中国
• CN: 中国专利英文摘要
• TW: 台湾英文摘要
• RU: 俄罗斯
• CO: 哥伦比亚
• SE: 瑞典
• ES: 西班牙
• IL: 以色列

排序选项

• PD: 公告日期
• AD: 申请日期
• GD: 注册日期
• OPD: 公开日期
• FD: 国际申请日期
• FOD: 国际公开日期
• RD: 优先权主张日期

专利状态代码

• A: 公开
• C: 更正公开
• F: 公告
• G: 更正公告
• I: 无效公告
• J: 撤销公告
• R: 再公告

Claude配置

使用Claude所需的配置如下：

安装方法

1. 需要Python 3.12及以上版本。
2. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# 或者
.venv\Scripts\activate  # Windows

3. 安装项目：

pip install -e .

API使用示例

SSE连接设置

1. 获取SSE连接及会话ID：

curl -N http://localhost:6274/messages/

响应示例：

event: endpoint
data: /messages/?session_id=<会话ID>

查询工具列表

curl http://localhost:6274/tools | jq .

专利搜索示例

1. 申请人搜索（三星电子最近的5项专利）：

curl -X POST "http://localhost:6274/messages/?session_id=<会话ID>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tool",
    "name": "patent_applicant_search",
    "args": {
      "applicant": "三星电子",
      "docs_count": 5,
      "desc_sort": true
    }
  }'

支持的工具列表

1. 韩国专利搜索：

   • patent_applicant_search: 按申请人搜索
   • patent_keyword_search: 按关键词搜索
   • patent_search: 按申请号搜索
   • patent_righter_search: 按权利人搜索
   • patent_application_number_search: 按申请号搜索
   • patent_summary_search: 按申请号查询概要信息
   • patent_detail_search: 按申请号查询详细信息

2. 海外专利搜索：

   • foreign_patent_applicant_search: 按申请人搜索
   • foreign_patent_application_number_search: 按申请号搜索
   • foreign_patent_free_search: 自由文本搜索
   • foreign_patent_international_application_number_search: 按国际申请号搜索
   • foreign_patent_international_open_number_search: 按国际公开号搜索

响应格式

所有API响应均以JSON格式返回，并具有以下结构：

[
  {
    "type": "text",
    "text": "搜索结果文本",
    "metadata": null
  }
]

日志记录

服务器默认提供DEBUG级别的日志记录。在日志中可以查看到以下信息：

• 工具调用开始/结束时间
• 工具执行耗时
• 发生错误时的详细信息

许可证

MIT License

贡献指南

1. Fork项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开Pull Request