Korean Patent MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Korean Patent MCP Search for Samsung Electronics' registered patents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ฐ๐ท Korean Patent MCP
ํ๊ตญ์ด ๋ฌธ์๋ ์๋์ ์์ต๋๋ค / Korean documentation below
MCP (Model Context Protocol) server for KIPRIS (Korean Intellectual Property Rights Information Service) API.
English Documentation
Overview
This MCP server enables AI assistants (Claude Desktop, Cursor, Windsurf, etc.) to search and analyze Korean patents through natural language queries. It connects to the official KIPRIS Plus Open API provided by the Korean Intellectual Property Office (KIPO).
Features
Tool | Description |
| Search patents by applicant name |
| Get detailed patent information by application number |
| Find patents that cite a specific patent |
Quick Start
# Install via Smithery (recommended)
npx -y @smithery/cli install korean-patent-mcp --client claude
# Or install via uv
uv pip install git+https://github.com/Tech-curator/korean-patent-mcp.gitRequirements
Python 3.10+
KIPRIS Plus Open API Key (Get your key here)
Configuration
Set the KIPRIS_API_KEY environment variable:
export KIPRIS_API_KEY="your_api_key_here"Or add to your MCP client configuration:
{
"mcpServers": {
"korean-patent": {
"command": "uv",
"args": ["run", "korean-patent-mcp"],
"env": {
"KIPRIS_API_KEY": "your_api_key_here"
}
}
}
}Example Queries
"Search for Samsung Electronics' registered patents"
"Get details for patent application number 1020200123456"
"Find patents that cite application 1020180056789"
Related MCP server: .KCI MCP Server (ํ๊ตญํ์ ์ง์ธ์ฉ์์ธ)
ํ๊ตญ์ด ๋ฌธ์
ํ๊ตญ ํนํ์ ๋ณด ๊ฒ์์๋น์ค(KIPRIS) API๋ฅผ ์ํ MCP(Model Context Protocol) ์๋ฒ์ ๋๋ค.
Claude Desktop, Cursor, Windsurf ๋๋ ๋ค๋ฅธ MCP ํด๋ผ์ด์ธํธ์ ์ฐ๋ํ์ฌ ์์ฐ์ด๋ก ํ๊ตญ ํนํ๋ฅผ ๊ฒ์ํ๊ณ ๋ถ์ํ ์ ์์ต๋๋ค.
โจ ๊ธฐ๋ฅ
Core Tools
Tool | ์ค๋ช |
| ์ถ์์ธ๋ช ์ผ๋ก ํนํ ๊ฒ์ |
| ์ถ์๋ฒํธ๋ก ํนํ ์์ธ ์ ๋ณด ์กฐํ |
| ํน์ ํนํ๋ฅผ ์ธ์ฉํ ํํ ํนํ ์กฐํ |
Extended Tools (ํฅํ ๊ตฌํ ์์ )
kipris_get_cpc_codes- CPC ๋ถ๋ฅ ์ฝ๋ ์กฐํkipris_get_inventors- ๋ฐ๋ช ์ ์ ๋ณด ์กฐํkipris_check_rejection- ๊ฑฐ์ ์ฌ๋ถ ํ์ธkipris_analyze_rejection_reason- ๊ฑฐ์ ์ฌ์ ๋ถ์
๐ ์ค์น ๋ฐฉ๋ฒ
๋ฐฉ๋ฒ 1: Smithery๋ฅผ ํตํ ์ค์น (๊ถ์ฅ)
# Smithery CLI ์ค์น (์ฒ์ ํ ๋ฒ๋ง)
npm install -g @smithery/cli
# Korean Patent MCP ์๋ฒ ์ค์น
smithery install korean-patent-mcp --client claude๋ฐฉ๋ฒ 2: uv๋ฅผ ์ฌ์ฉํ ๋ก์ปฌ ์ค์น
# ์ ์ฅ์ ํด๋ก
git clone https://github.com/khreat/korean-patent-mcp.git
cd korean-patent-mcp
# uv๋ก ์ค์น (๊ถ์ฅ)
uv pip install -e .
# ๋๋ pip์ผ๋ก ์ค์น
pip install -e .์๊ตฌ์ฌํญ
Python 3.10+
KIPRIS Plus Open API ํค (๋ฐ๊ธ ์ฌ์ดํธ)
๐ง ์ค์
API ํค ์ค์
.env ํ์ผ์ ์์ฑํ๊ณ API ํค๋ฅผ ์ค์ ํฉ๋๋ค:
echo "KIPRIS_API_KEY=your_api_key_here" > .env๋๋ ํ๊ฒฝ๋ณ์๋ก ์ค์ :
export KIPRIS_API_KEY="your_api_key_here"๐ ํด๋ผ์ด์ธํธ ์ฐ๋
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ๋๋
%APPDATA%\Claude\claude_desktop_config.json (Windows) ํ์ผ์ ํธ์งํฉ๋๋ค:
{
"mcpServers": {
"korean-patent": {
"command": "uv",
"args": ["run", "korean-patent-mcp"],
"env": {
"KIPRIS_API_KEY": "your_api_key_here"
}
}
}
}Cursor / Windsurf
MCP ์ค์ ์์ ๋ค์์ ์ถ๊ฐํฉ๋๋ค:
{
"korean-patent": {
"command": "uv",
"args": ["run", "korean-patent-mcp"],
"env": {
"KIPRIS_API_KEY": "your_api_key_here"
}
}
}๐ ์ฌ์ฉ ์์
Claude Desktop์์ ๋ค์๊ณผ ๊ฐ์ด ์ง๋ฌธํ ์ ์์ต๋๋ค:
ํนํ ๊ฒ์
์ผ์ฑ์ ์๊ฐ ์ถ์ํ ํนํ ์ค ๋ฑ๋ก๋ ๊ฒ๋ค์ ๋ณด์ฌ์ค์ถฉ๋ถ๋ํ๊ต ์ฐํํ๋ ฅ๋จ์ ์ต๊ทผ ํนํ๋ฅผ ๊ฒ์ํด์คํนํ ์์ธ ์ ๋ณด
์ถ์๋ฒํธ 1020200123456์ ํนํ ์์ธ ์ ๋ณด๋ฅผ ์๋ ค์ค์ธ์ฉ ํนํ ๋ถ์
์ถ์๋ฒํธ 1020180056789๋ฅผ ์ธ์ฉํ ํนํ๋ค์ ์ฐพ์์ค๐งช ๊ฐ๋ฐ & ํ ์คํธ
MCP Inspector๋ก ํ ์คํธ
npx @modelcontextprotocol/inspector uv run korean-patent-mcpSmithery Dev ๋ชจ๋
smithery dev๐ ํ๋ก์ ํธ ๊ตฌ์กฐ
korean-patent-mcp/
โโโ pyproject.toml # ํจํค์ง ์ค์ (uv/pip ํธํ)
โโโ smithery.yaml # Smithery ๋ฐฐํฌ ์ค์
โโโ README.md
โโโ .env.example
โโโ src/
โโโ korean_patent_mcp/
โโโ __init__.py
โโโ server.py # MCP ์๋ฒ & Tool ์ ์
โโโ kipris_api.py # KIPRIS API ํด๋ผ์ด์ธํธ๐ API ์๋ต ํ์
๋ชจ๋ Tool์ response_format ํ๋ผ๋ฏธํฐ๋ฅผ ์ง์ํฉ๋๋ค:
markdown(๊ธฐ๋ณธ๊ฐ): ์ฌ๋์ด ์ฝ๊ธฐ ์ข์ ํ์json: ํ๋ก๊ทธ๋๋ฐ ์ฒ๋ฆฌ์ ์ ํฉํ ๊ตฌ์กฐํ๋ ํ์
โ ๏ธ ์ฃผ์์ฌํญ
KIPRIS API๋ ํธ์ถ ์ ํ์ด ์์ ์ ์์ต๋๋ค
๋๋ ๊ฒ์ ์ ํ์ด์ง๋ค์ด์ ์ ํ์ฉํ์ธ์
API ํค๋ ์ ๋ ๊ณต๊ฐ ์ ์ฅ์์ ์ปค๋ฐํ์ง ๋ง์ธ์
๐ ๋ผ์ด์ ์ค
MIT License
๐ค ๊ธฐ์ฌ
๋ฒ๊ทธ ๋ฆฌํฌํธ, ๊ธฐ๋ฅ ์ ์, PR ๋ชจ๋ ํ์ํฉ๋๋ค!
๐ Contact
Tech Curator: https://techcurator.kr
DiME: https://www.dime.kr
E-mail: jkh25@techcurator.kr / ceo@techcurator.kr
Made with โค๏ธ for Korean patent research
Available Tools
3 toolskipris_get_citing_patentsC
ํน์ ํนํ๋ฅผ ์ธ์ฉํ ํํ ํนํ๋ค์ ์กฐํํฉ๋๋ค.
Args:
application_number: ๊ธฐ์ค ํนํ์ ์ถ์๋ฒํธ (ํ์)
response_format: ์๋ต ํ์ ('markdown' ๋๋ 'json')
Inputs: application_number (required), response_format. Returns: result
kipris_get_patent_detailC
์ถ์๋ฒํธ๋ก ํนํ์ ์์ธ ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค.
Args:
application_number: ์ถ์๋ฒํธ (ํ์, ์: '1020200123456')
response_format: ์๋ต ํ์ ('markdown' ๋๋ 'json')
Inputs: application_number (required), response_format. Returns: result
kipris_search_patentsB
์ถ์์ธ๋ช ์ผ๋ก ํ๊ตญ ํนํ๋ฅผ ๊ฒ์ํฉ๋๋ค.
Args:
applicant_name: ์ถ์์ธ๋ช
(ํ์, ์: '์ผ์ฑ์ ์', '์นด์นด์ค๋ฑ
ํฌ')
page: ํ์ด์ง ๋ฒํธ (๊ธฐ๋ณธ๊ฐ: 1)
page_size: ํ์ด์ง๋น ๊ฒฐ๊ณผ ์ (๊ธฐ๋ณธ๊ฐ: 20, ์ต๋: 100)
status: ์ํ ํํฐ ('A': ๊ณต๊ฐ, 'R': ๋ฑ๋ก, 'J': ๊ฑฐ์ , None: ์ ์ฒด)
response_format: ์๋ต ํ์ ('markdown' ๋๋ 'json')
Inputs: applicant_name (required), page, page_size, status, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose with no overlap: one retrieves patents citing a specific patent, another gets detailed information for a single patent, and the third searches patents by applicant name. The descriptions clearly differentiate these functions, making tool selection unambiguous for an agent.
All tool names follow a consistent 'kipris_verb_noun' pattern (kipris_get_citing_patents, kipris_get_patent_detail, kipris_search_patents). This uniform naming convention makes the tool set predictable and easy to understand, with no deviations in style or structure.
With only 3 tools, the set feels thin for a patent domain that typically involves more operations like updating, deleting, or analyzing patents. While the tools cover basic retrieval and search, the count is borderline low for comprehensive patent management, limiting agent capabilities.
The tool surface has significant gaps for a patent server, lacking essential operations such as creating, updating, or deleting patents, as well as advanced features like patent analysis or filtering by other criteria. This incompleteness will likely cause agent failures in handling full patent workflows.
Maintenance
Related MCP Connectors
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Patent search, inventor search, patents-by-assignee and full patent detail as agent tools.
AI-powered patent intelligence for search & analysis
Global patent search, briefs, similarity, citations and landscape stats. Strong China coverage.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables searching and retrieving South Korean intellectual property data via the KIPRIS Plus Open API. Users can perform patent searches, look up bibliographic information, and convert natural language into KIPRIS search queries.62MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to search and analyze Korean academic papers using the Korea Citation Index (KCI) Open API. Supports paper search, detailed metadata retrieval, reference analysis, author and keyword searches, and citation index queries.1-
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to perform patent search, portfolio analysis, technology trend tracking, and semantic prior-art search using USPTO data.MIT
- AlicenseAqualityCmaintenanceMCP server that enables searching Korean patents, trademarks, and designs via KIPRIS Plus open APIs. Supports keyword, advanced, applicant, and rightholder searches with detailed bibliographic lookup.764MIT