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 the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request