使用说明
KIPRIS Plus MCP服务器
提供KIPRIS Plus Open API作为模型上下文协议(MCP)工具的服务器。
注册并使用Claude Desktop、Cursor和其他MCP兼容客户端。
提供工具(Tools)
| 工具名 | 说明 |
|---|---|
kipris_search |
KIPRIS搜索表达式(query)直接输入搜索 |
kipris_item_search |
按字段搜索条件输入(申请人、发明者、IPC、日期等) |
kipris_free_search |
关键字自由搜索 |
kipris_bibliography |
通过申请号码查询书面信息单件 |
kipris_build_query |
转换自然语言→KIPRIS搜索表达式 |
安装方法
1.前提条件
- Node.js 18或更高版本 (nodejs.org 在中安装)
- Kipris Plus API (加上kipris.or.kr 在中注册后发放)
2.安装软件包
# 프로젝트 폴더로 이동
cd kipris-mcp
# 의존성 설치
npm install
3.在MCP客户端注册
克劳德桌面
设置文件位置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
以下内容 mcpServers 添加到块:
{
"mcpServers": {
"kipris": {
"command": "node",
"args": ["/절대경로/kipris-mcp/src/index.js"],
"env": {
"KIPRIS_API_KEY": "여기에_발급받은_API키_입력"
}
}
}
}
args的路径 实际绝对路径请用替换。
是(MacOS):"/Users/yourname/kipris-mcp/src/index.js"
是(Windows):"C:\\Users\\yourname\\kipris-mcp\\src\\index.js"
光标
.cursor/mcp.json 或者,在Cursor设置的MCP部分中添加相同的内容。
其他MCP客户端
基于stdio的MCP服务器,直接运行以下命令:
KIPRIS_API_KEY=발급키 node src/index.js
使用示例
您可以要求Claude:
삼성전자의 배터리 관련 특허를 최신 순으로 30건 검색해줘
LG화학이나 삼성SDI가 2021년 이후 출원한 전고체 배터리 특허를 찾아줘
출원번호 1020200012345의 서지정보를 조회해줘
"홍길동 발명자의 반도체 공정 특허"를 KIPRIS 검색식으로 변환하고 검색해줘
请参阅搜索语法
运算符符号示例
|--------|------|------|
|以及| * | TI=배터리*AP=삼성전자 |
|或| + | TI=배터리+TI=전지 |
|不是| ! | TI=배터리!TI=리튬 |
字段代码含义示例
|---------|------|------|
| TI |发明的名称| TI=배터리 |
| AB |摘要| AB=리튬이온 |
| CL |计费范围| CL=전극재료 |
| AP |申请人| AP=삼성전자 |
| INV |发明者| INV=홍길동 |
| IPC | IPC分类代码| IPC=H01M |
| AD |申请日期范围| AD=20200101~20241231 |
| GD |注册日期范围| GD=20220101~ |
结果字段(文档信息)
搜索结果仍然包含KIPRIS主页的内置内容:
| 字段 | 说明 |
|---|---|
| 发明名称专利/实用新型发明名称 | |
| 申请编号申请编号 | |
| 申请日申请日 | |
| 申请人申请人名 | |
| 发明者发明者姓名 | |
| 代理人 | 代理人(专利法人)名 |
| 注册号注册号 | |
| 注册日期注册日期 | |
| 公开号码公开号码 | |
| 公开日期公开日期 | |
| 公告编号 | 公告编号 |
| 公告日公告日 | |
| IPC | IPC分类代码 |
| CPC CPC分类代码 | |
| 状态 | 专利状态(注册/公开/公告/终止等) |
| 摘要 | 发明摘要(摘要) |
注意事项
- 搜索结果 超过500件 时返回警告消息。请把条件具体化,限定范围。
- KIPRIS Plus API免费账号 每月1000件,每秒50件 呼叫限制不足。
- API密钥是环境变量
KIPRIS_API_KEY请只传达。不要直接插入代码中。