Korean Patent MCP (KIPRIS)
특허청 KIPRIS Plus 오픈API를 MCP 도구로 노출하는 서버. 특허·실용신안·상표·디자인을 키워드/항목/출원인/권리자로 검색하고, 출원번호로 상세 서지정보를 조회한다.
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चkorean-law-mcp 아키텍처를 벤치마킹 — lib/tools 레이어 분리, fetch 재시도·키 마스킹, Zod 검증, stateless HTTP, TTL 캐시, 응답 크기 제한, [NOT_FOUND] 환각방지 패턴.
공개 remote 서버가 떠 있어 설치 없이 바로 쓸 수 있다. 공식 주소는 통합 호스트 하나뿐이다
(구 개별 주소 korean-patent-mcp.fly.dev 는 통합 후 중단 — 설정에 남아 있으면 아래로 교체):
https://mcp.gomdori.app/patent
kipris-key 헤더로 전달 가능, 없으면 서버 공용 키 폴백)claude mcp add --transport http korean-patent https://mcp.gomdori.app/patentnpm install
npm run build
KIPRIS Plus 인증키가 필요하다. plus.kipris.or.kr 회원가입 후 사용할 서비스(특허·실용 / 상표 / 디자인)를 각각 활용신청하면 단일 인증키로 모두 호출된다. (data.go.kr 발급 키도 동일 키 체계.)
cp .env.example .env
# .env 에 KIPRIS_API_KEY=발급키 입력
권한은 오퍼레이션(상세기능) 단위다. 신청하지 않은 기능은
resultCode 30(미등록)으로 거부된다. 예: 특허만 신청했다면search_trademark/search_design은 30 을 반환한다. 각 서비스를 추가 신청하면 즉시 동작한다.
{
"mcpServers": {
"korean-patent": {
"command": "node",
"args": ["/절대경로/korean-patent-mcp/build/index.js"],
"env": { "KIPRIS_API_KEY": "발급키" }
}
}
}
node build/index.js --mode http --port 8000
# 키: 요청 헤더(apikey / x-api-key / kipris-key / Authorization: Bearer) 또는 서버 환경변수 폴백
키는 요청별(BYOK) 헤더가 우선이고, 없으면 서버 KIPRIS_API_KEY 로 폴백한다.
폴백 호출은 무료 한도(1,000회/월)를 보호해야 하는데, 실질 방어선은 분당이 아니라 일일 총량이다
(분당 상한만으로는 하루 이론 최대가 월 한도를 수십 배 넘는다). 그래서 분당 게이트는 버스트 흡수용으로만
두고 총량은 FALLBACK_DAILY_CAP(기본 30 ≈ 1,000÷31)이 잡는다. 두 게이트 모두 tools/call만 계수하며,
핸드셰이크(initialize/tools/list)는 KIPRIS 쿼터를 쓰지 않으므로 계수하지 않는다 — 계수하면 커넥터가
붙을 때마다 쿼터가 깎여 도구 목록조차 못 싣는다.
HTTP 모드 환경변수
429 응답에는 Retry-After 헤더와 본문 대기 초 안내가 실린다.
Docker / Fly.io:
flyctl launch --dockerfile Dockerfile
flyctl secrets set KIPRIS_API_KEY=발급키
flyctl deploy
공통 옵션 (get_patent_detail 은 applicationNumber 만 받는다)
numOfRows (1~100, 기본 10), pageNo (기본 1) — 검색 6종 공통, 페이징 지원patent / utility — 검색 대상 (특허/실용신안). 상표·디자인 검색에는 없음descSort — 내림차순(최신순) 여부. 상표·디자인 검색에는 없음sortSpec — AD(출원일) OPD(공개일) GD(공고일) RD(등록일) PD(우선일). 자유검색·항목검색만withAbstract — (자유검색) 초록 본문 포함+ * ? ! ^ 는 KIPRIS 검색연산자로 해석된다.
예) C++ 는 + 가 연산자로 작동해 의도와 다른 결과가 나올 수 있다. 정확검색은 항목검색(search_patents_advanced)을 사용.ForeignPatentAdvencedSearchService)이며 현재 인증키에 미신청 상태(resultCode 30)라 미지원. 활용신청 시 도구 추가 가능.⚠️ 표기) — 레코드가 중간에 끊겨 LLM 이 오인하는 것을 방지. (문자 수 기준이라 한글은 UTF-8 로 최대 ~150KB) 더 보려면 numOfRows 를 줄이거나 pageNo 로 페이징.[NOT_FOUND] 로 명시 반환 (LLM 환각 방지). 깊은 페이지(pageNo>1)의 0건은 "마지막 페이지 도달" 가능성을 별도 안내.https. 키가 쿼리스트링에 실리므로 평문 노출 방지. (KIPRIS_API_PROTOCOL=http 로만 평문 전환)src/
├── index.ts 진입점 (STDIO / HTTP 모드)
├── version.ts 서버 버전 단일 출처 (MCP serverInfo · 루트 `/` 정보 응답)
├── tool-registry.ts 도구 7개 등록 + Zod→JSON Schema 변환 (apiKey 숨김)
├── lib/
│ ├── api-client.ts KIPRIS 엔드포인트 래핑 (openapi/rest + kipo-api)
│ ├── fetch-with-retry.ts 타임아웃·재시도·키 마스킹
│ ├── xml-parser.ts 헤더검사·검색목록·항목검색·상표·디자인·서지상세 파싱
│ ├── format.ts 도메인별 결과 텍스트 포맷팅
│ ├── errors.ts KIPRIS resultCode 표준화 + 환각방지
│ ├── rate-limit.ts 폴백 게이트 — 토큰버킷 + 롤링 일일 캡
│ ├── cache.ts TTL+LRU 캐시
│ ├── schemas.ts 응답 크기 제한
│ ├── session-state.ts 요청별 키 격리 (AsyncLocalStorage)
│ └── types.ts
├── tools/ search / advanced / applicant / rightholder / detail / trademark / design
└── server/http-server.ts Streamable HTTP (rate limit, CORS, trust proxy)
MIT
KIPRIS 특허·실용신안·상표·디자인 검색 MCP — 자유검색/항목검색/출원인/권리자/서지상세 7개 도구 | KIPRIS Korean patent·utility·trademark·design search → 7 MCP tools
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Korean Patent stdio पर लोकल चलता है।
पिछली जाँच 2026-11-17 को हुई। KIPRIS 특허·실용신안·상표·디자인 검색 MCP — 자유검색/항목검색/출원인/권리자/서지상세 7개 도구 | KIPRIS Korean patent·utility·trademark·design search → 7 MCP tools