kipris-mcp-server

KIPRIS(한국 특허정보검색서비스) 특허 검색을 위한 경량 Node/npx MCP 서버. KIPRIS Plus Open API를 감싸서 MCP 클라이언트(ixi-Enterprise Agent Builder, Claude Desktop 등)가 한국 특허·실용신안을 자연어로 검색할 수 있게 한다.

uvx(Python) 러너를 쓸 수 없는 환경(보안망 등)을 위한 npx 대안으로 만들어졌다.

도구 (Tools)

| 도구 | 설명 | 인자 | |---|---|---| | patent_free_search | 키워드 자유검색 | word(필수), numOfRows, pageNo, patent, utility, descSort | | patent_applicant_search | 출원인명으로 검색 | applicant(필수), docsCount, docsStart, patent, utility, descSort | | patent_detail | 출원번호로 서지상세 조회 | applicationNumber(필수) |

실행

KIPRIS API 키가 필요하다 (https://plus.kipris.or.kr 에서 무료 발급, Open API 활용신청).

KIPRIS_API_KEY=발급키 npx -y kipris-mcp-server

MCP 클라이언트 설정 (예: ixi-E / Claude Desktop)

{
  "mcpServers": {
    "kipris": {
      "command": "npx",
      "args": ["-y", "kipris-mcp-server"],
      "env": {
        "KIPRIS_API_KEY": "<발급받은_KIPRIS_API_키>"
      }
    }
  }
}

• 전송 방식: stdio
• 인증: KIPRIS_API_KEY 환경변수 (코드에 키를 넣지 않는다)

KIPRIS 응답 코드

| code | 의미 | |---|---| | 00 | 정상 | | 10 | 잘못된 요청 파라미터 | | 20 | 결과 없음 (빈 결과로 처리) | | 30 | 등록되지 않은 accessKey | | 31 | 기한 만료 |

엔드포인트 (KIPRIS Plus)

• 자유검색: openapi/rest/patUtiModInfoSearchSevice/freeSearchInfo (accessKey)
• 출원인검색: openapi/rest/patUtiModInfoSearchSevice/applicantNameSearchInfo (accessKey)
• 서지상세: kipo-api/kipi/patUtiModInfoSearchSevice/getBibliographyDetailInfoSearch (ServiceKey)

License

MIT