MCP kipris

MCP KIPRIS

   

英语 | 韩语→

一 MCP（模型上下文协议） 服务器，让像克劳德这样的人工智能助手可以直接访问 吉卜里斯 --韩国知识产权局（KIPO）运营的韩国官方专利和商标数据库。

______________________________________________________________________

为什么选择KIPRIS？

韩国是 前五大专利申请国 在世界上。三星、LG、SK海力士、现代和浦项制铁等公司每年提交数万项专利，所有这些专利都可以通过KIPRIS进行搜索。

此MCP服务器允许Claude（或任何兼容MCP的AI客户端）以自然语言搜索这些专利，而无需用户浏览韩语KIPRIS门户网站。

典型用例：

• 申请专利前的现有技术检索
• 韩国科技公司的竞争情报
• 监控特定技术领域的IPC分类
• 韩国市场商标清关

______________________________________________________________________

快速开始

先决条件： Python 3.11+，一个免费的 KIPRIS API密钥

# 1. Clone and install
git clone https://github.com/nuri428/mcp_kipris.git
cd mcp_kipris
pip install -e .

# 2. Set your API key
export KIPRIS_API_KEY="your_api_key_here"

# 3. Run the server (stdio mode for Claude Desktop)
python -m mcp_kipris.server

然后将服务器添加到Claude Desktop——请参阅 Claude桌面配置.

______________________________________________________________________

获取KIPRIS API密钥

1. 首选 https://plus.kipris.or.kr *（网站为韩语，请使用浏览器翻译）*
2. 注册一个免费账户
3. 从开发人员门户申请Open API密钥
4. 您的密钥可免费用于非商业用途，每日请求配额

______________________________________________________________________

特性

韩国专利检索

商标检索

国际专利检索

通过KIPRIS的国际数据库搜索来自13个国家的专利：

______________________________________________________________________

安装

选项1：来自PyPI（推荐）

pip install mcp-kipris

选项2：来源（开发）

git clone https://github.com/nuri428/mcp_kipris.git
cd mcp_kipris

# Option A — using uv (recommended)
pip install uv
uv sync

# Option B — using pip
pip install -e .

环境配置

# Shell export (session-scoped)
export KIPRIS_API_KEY="your_api_key_here"

# Or create a .env file at the project root
echo 'KIPRIS_API_KEY=your_api_key_here' > .env

______________________________________________________________________

运行服务器

stdio模式——适用于Claude Desktop和大多数MCP客户端

# via uv
uv run python -m mcp_kipris.server

# via python directly (if installed with pip install -e .)
python -m mcp_kipris.server

HTTP/SSE模式——适用于基于web的MCP客户端

uv run python -m mcp_kipris.sse_server --http --port 6274 --host 0.0.0.0

通过mcpo代理（stdio→ HTTP网桥）

uvx mcpo --port 6274 -- uv run python -m mcp_kipris.server

码头工人

bash sse_server_build.sh

______________________________________________________________________

Claude桌面配置

将此块添加到您的Claude桌面 claude_desktop_config.json （通常在 ~/Library/Application Support/Claude/ 在macOS上）：

{
  "mcpServers": {
    "kipris": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_kipris.server"],
      "cwd": "/absolute/path/to/mcp_kipris",
      "env": {
        "KIPRIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Settings

______________________________________________________________________

测试

运行测试套件

测试结果 实时API调用 并要求有效 KIPRIS_API_KEY.

# Install and run
uv sync
pytest test/ -v --cov=src/mcp_kipris --cov-report=term-missing

单个测试脚本也可以直接运行：

python test/test_samsung_patents.py
python test/test_patent_keyword_search.py

棉绒和格式

ruff check src/
ruff format src/

分布测试

在标记发布之前，请验证软件包的构建和安装是否干净：

# 1. Build wheel and sdist
pip install build
python -m build

# 2. Smoke-test the wheel in a clean virtualenv
python -m venv /tmp/kipris-smoke
source /tmp/kipris-smoke/bin/activate
pip install dist/mcp_kipris-*.whl
python -c "import mcp_kipris; print('import OK')"
deactivate
rm -rf /tmp/kipris-smoke

# 3. Verify editable install still works
pip install -e .
pytest test/ -v

CI矩阵

每次推送和拉取请求 main / develop 运行整个管道 Python 3.11和3.12:

______________________________________________________________________

API使用示例

这些示例使用HTTP/SSE服务器模式。首先，获取会话ID：

# Start the SSE server
uv run python -m mcp_kipris.sse_server --http --port 6274 --host 0.0.0.0

# Get a session ID
curl -N http://localhost:6274/messages/
# → event: endpoint
# → data: /messages/?session_id=

按申请人检索专利--三星电子

# "삼성전자" is the Korean name for Samsung Electronics
curl -X POST "http://localhost:6274/messages/?session_id=" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tool",
    "name": "patent_applicant_search",
    "args": {
      "applicant": "삼성전자",
      "docs_count": 5,
      "desc_sort": true
    }
  }'

列出所有可用工具

curl http://localhost:6274/tools | jq .

响应格式

所有工具都返回一个封装在这个信封中的Markdown表：

[
  {
    "type": "text",
    "text": "| application_number | title | applicant | ...\n|---|---|---|...",
    "metadata": null
  }
]

______________________________________________________________________

参考

支持的国家代码（国际搜索）

排序选项

专利状态代码

______________________________________________________________________

Claude工作技能

如果你使用 ClaudeWork，此服务器也打包为即用型技能：

吉卜里斯技能→

______________________________________________________________________

贡献

看 Developpent.md 获取完整的开发人员指南和CI/CD设置。

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/my-feature
3. 提交您的更改： git commit -m 'feat: add my feature'
4. 推： git push origin feature/my-feature
5. 打开拉取请求

提交前：

ruff check src/   # lint
ruff format src/  # format
pytest test/      # tests (requires KIPRIS_API_KEY)

这 KIPRIS_API_KEY 因为CI存储为GitHub Secret，您不需要提交它。

______________________________________________________________________

致谢

特别感谢 @haseo ai 对于5个显著扩展此项目的pull请求：

• 摘要搜索 (PatentAbstractSearchTool)--按发明摘要检索专利
• IPC代码搜索 (PatentIPCSearchTool)--按国际分类代码搜索
• 代理搜索 (PatentAgentSearchTool)--按注册专利代理人名称搜索
• 商标检索 (TrademarkSearchTool)--韩国商标关键词搜索
• 改进了API错误处理 -为KIPRIS API响应提供更强大的错误管理

______________________________________________________________________

许可证

MIT许可证