MCP 服务器

KIPRIS Plus MCP Server

Enables searching and retrieving South Korean intellectual property data via the KIPRIS Plus Open API. Users can perform patent searches, look up bibliographic information, and convert natural language into KIPRIS search queries.

README

KIPRIS Plus MCP Server

KIPRIS Plus Open API를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다.
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 키 (plus.kipris.or.kr 에서 회원가입 후 발급)

2. 패키지 설치

# 프로젝트 폴더로 이동
cd kipris-mcp

# 의존성 설치
npm install

3. MCP 클라이언트에 등록

Claude Desktop

설정 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %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

.cursor/mcp.json 또는 Cursor 설정의 MCP 섹션에 동일하게 추가합니다.

기타 MCP 클라이언트

stdio 기반 MCP 서버로, 아래 명령으로 직접 실행합니다:

KIPRIS_API_KEY=발급키 node src/index.js

사용 예시

Claude에게 아래와 같이 요청할 수 있습니다:

삼성전자의 배터리 관련 특허를 최신 순으로 30건 검색해줘

LG화학이나 삼성SDI가 2021년 이후 출원한 전고체 배터리 특허를 찾아줘

출원번호 1020200012345의 서지정보를 조회해줘

"홍길동 발명자의 반도체 공정 특허"를 KIPRIS 검색식으로 변환하고 검색해줘

검색식 문법 참조

연산자	기호	예시
AND	`*`	`TI=배터리*AP=삼성전자`
OR	`+`	`TI=배터리+TI=전지`
NOT	`!`	`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 분류코드
상태	특허 상태 (등록/공개/공고/소멸 등)
요약	발명 요약(초록)