Skip to main content
Glama
SilverQ

KIPRIS Plus MCP Server

by SilverQ

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 검색식 변환


Related MCP server: Korean Patent MCP

설치 방법

1. 사전 요구사항

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 분류코드

상태

특허 상태 (등록/공개/공고/소멸 등)

요약

발명 요약(초록)


주의사항

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

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

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

Available Tools

6 tools
kipris_bibliographyC

KIPRIS Plus 서지정보 상세 조회. 출원번호로 단건 특허의 상세 서지정보를 가져옵니다.

ParametersJSON Schema
NameRequiredDescriptionDefault
applicationNumberYes출원번호. 예: 1020200012345

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool retrieves detailed bibliographic information, implying a read-only operation, but doesn't disclose other behavioral traits such as authentication requirements, rate limits, error handling, or response format. For a tool with zero annotation coverage, this leaves significant gaps in understanding how it behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded, consisting of two concise sentences that directly state the tool's purpose and usage. There is no wasted language, and every sentence contributes essential information without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (a single-parameter lookup tool), lack of annotations, and no output schema, the description is incomplete. It doesn't explain what the return values include (e.g., fields in the bibliographic information), error conditions, or other contextual details needed for effective use. The description should provide more context to compensate for the absence of structured data.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds minimal meaning beyond the input schema. It mentions that the parameter 'applicationNumber' is used to fetch detailed bibliographic information for a single patent, but the schema already has 100% coverage with a clear description and example. Since schema_description_coverage is high, the baseline is 3, and the description doesn't significantly enhance parameter understanding beyond what the schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'KIPRIS Plus 서지정보 상세 조회' (KIPRIS Plus bibliographic detail lookup) and specifies it retrieves detailed bibliographic information for a single patent using an application number. It distinguishes from siblings by focusing on detailed lookup rather than search or query-building operations. However, it doesn't explicitly contrast with specific sibling tools like 'kipris_item_search' which might also retrieve patent details.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides minimal usage guidance: it indicates the tool is for retrieving detailed bibliographic information by application number. However, it offers no explicit guidance on when to use this tool versus alternatives (e.g., when to use 'kipris_search' for broader searches or 'kipris_item_search' for other item types), no prerequisites, and no exclusions. Usage is implied but not clearly articulated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kipris_build_queryA

자연어 검색 의도를 KIPRIS 검색식(query)으로 변환합니다. 변환 결과를 kipris_search에 전달해 실제 검색을 수행하세요.

ParametersJSON Schema
NameRequiredDescriptionDefault
intentYes자연어 검색 의도. 예: '삼성전자의 배터리 특허 2020년 이후', '홍길동 발명자의 반도체 특허'

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It describes the conversion behavior but lacks details on potential limitations, error handling, or output format. For a tool with no annotation coverage, this is a significant gap in behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded, consisting of two concise sentences that directly explain the tool's function and usage without any wasted words. Every sentence earns its place by providing essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (simple conversion with one parameter), no annotations, and no output schema, the description is adequate but incomplete. It explains the purpose and basic usage but lacks details on output format or behavioral traits, which are needed for full contextual understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so the schema already documents the single parameter 'intent' with examples. The description adds minimal value by restating '자연어 검색 의도' but doesn't provide additional syntax or format details beyond what the schema provides, meeting the baseline for high coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: converting natural language search intent into KIPRIS search queries. It specifies the input ('자연어 검색 의도') and output ('KIPRIS 검색식'), though it doesn't explicitly differentiate from all sibling tools like kipris_free_search or kipris_search beyond mentioning the latter as the next step.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context on when to use this tool: for converting natural language intent into a structured query, and it explicitly states to pass the result to kipris_search for actual searching. However, it doesn't mention when not to use it or alternatives among siblings like kipris_free_search.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv1.0.0
    • First observedkipris_bibliography
    • First observedkipris_build_query
    • First observedkipris_cpc_search
    • First observedkipris_free_search
    • First observedkipris_item_search
    • First observedkipris_search

TDQS

A3.6/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: kipris_bibliography retrieves detailed bibliographic information for a single patent, kipris_build_query converts natural language to a search query, kipris_cpc_search searches by CPC code, kipris_free_search performs keyword searches across all fields, kipris_item_search allows field-specific searches, and kipris_search handles keyword searches in patent text. There is no overlap or ambiguity between these functions.

Naming Consistency5/5

All tool names follow a consistent pattern: they start with 'kipris_' followed by a descriptive term (e.g., bibliography, build_query, cpc_search). This uniform prefix and snake_case structure make the tools easily identifiable and predictable.

Tool Count5/5

With 6 tools, this server is well-scoped for patent search and retrieval. It covers key operations like detailed lookups, query building, and various search methods (CPC, free, item-specific), which is appropriate for the domain without being overwhelming or insufficient.

Completeness4/5

The tool set provides comprehensive coverage for patent search and retrieval, including query building, multiple search types, and detailed information access. A minor gap is the lack of explicit update or delete operations, but this is reasonable given the server's focus on querying a static patent database, and agents can work effectively with the provided tools.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    B
    maintenance
    Enables AI systems to search, retrieve, and analyze Korean legal information from the National Law Information API (law.go.kr), including laws, administrative rules, English translations, and law-ordinance linkages.
    26
    2
    -
  • A
    license
    B
    quality
    D
    maintenance
    Enables searching and analyzing Korean patents through the KIPRIS API using natural language. Supports patent search by applicant name, detailed patent information retrieval, and citation analysis.
    3
    2
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    Provides access to USPTO patent and patent application data through multiple APIs, enabling search, retrieval, and analysis of patents, PTAB proceedings, and litigation data via natural language.
    61
    79
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Integrates with KISTI's ScienceON, NTIS, and DataON APIs to search and retrieve scientific papers, patents, reports, national R\&D projects, and research data.
    15
    Creative Commons Attribution Non Commercial 4.0 International