Korean Patent MCP (KIPRIS)
특허청 KIPRIS Plus 오픈API를 MCP 도구로 노출하는 서버. 특허·실용신안·상표·디자인을 키워드/항목/출원인/권리자로 검색하고, 출원번호로 상세 서지정보를 조회한다.
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 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-10-27. KIPRIS 특허·실용신안·상표·디자인 검색 MCP — 자유검색/항목검색/출원인/권리자/서지상세 7개 도구 | KIPRIS Korean patent·utility·trademark·design search → 7 MCP tools