KIPRIS Plus MCP Server

KIPRIS Plus Open API를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다.
Claude Desktop, Cursor, 기타 MCP 호환 클라이언트에 등록해 사용합니다.

제공 도구 (Tools)

설치 방법

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 검색식으로 변환하고 검색해줘

검색식 문법 참조

결과 필드 (서지정보)

검색 결과에는 KIPRIS 홈페이지 기본 제공 항목이 그대로 포함됩니다:

주의사항

• 검색 결과 500건 초과 시 경고 메시지가 반환됩니다. 조건을 구체화해 범위를 한정하세요.

• KIPRIS Plus API 무료 계정은 월 1,000건, 초당 50건 미만 호출 제한이 있습니다.

• API 키는 환경변수 KIPRIS_API_KEY로만 전달하세요. 코드에 직접 삽입하지 마세요.