Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
특허 검색이 아니라 존속 판정: 특허·실용신안 번호가 지금도 유효한지 등록원부 연차료까지 대조해 소멸 사유와 함께 알려줍니다
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 4/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 7/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 11/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
Korean Patent Status — 특허 존속 여부 판정 をインストールして。https://mcp.popnx.com/i/didrod205-korean-patent-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
Korean Patent Status — 특허 존속 여부 판정 のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server Korean Patent Status — 특허 존속 여부 판정 を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "korean-patent": { "command": "npx", "args": [ "-y", "korean-patent-mcp" ], "env": { "KIPRIS_SERVICE_KEY": "your-value", "DATA_GO_KR_SERVICE_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korean Patent Status — 특허 존속 여부 판정 のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"korean-patent": {
"command": "npx",
"args": [
"-y",
"korean-patent-mcp"
],
"env": {
"KIPRIS_SERVICE_KEY": "your-value",
"DATA_GO_KR_SERVICE_KEY": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Korean Patent Status — 특허 존속 여부 판정 を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Korean Patent Status — 특허 존속 여부 판정 を使っていると言うか、回答に Korean Patent Status — 특허 존속 여부 판정 のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
KIPRIS_CACHE_TTL 任意。同じ番号の照会結果をキャッシュする時間(秒)。既定値は 3600。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Korean Patent Status — 특허 존속 여부 판정 につなげません
Korean Patent Status — 특허 존속 여부 판정 はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · Korean Patent Status — 특허 존속 여부 판정 につなげるアプリを使う
B · 法律・行政データ の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
Korean Patent Status — 특허 존속 여부 판정 のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server Korean Patent Status — 특허 존속 여부 판정 を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user korean-patent --env KIPRIS_SERVICE_KEY=your-value --env DATA_GO_KR_SERVICE_KEY=your-value -- npx -y korean-patent-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korean Patent Status — 특허 존속 여부 판정 のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user korean-patent --env KIPRIS_SERVICE_KEY=your-value --env DATA_GO_KR_SERVICE_KEY=your-value -- npx -y korean-patent-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Korean Patent Status — 특허 존속 여부 판정 が一覧にあり、接続済みと表示されれば OK です
Korean Patent Status — 특허 존속 여부 판정 を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Korean Patent Status — 특허 존속 여부 판정 を使っていると言うか、回答に Korean Patent Status — 특허 존속 여부 판정 のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
KIPRIS_CACHE_TTL 任意。同じ番号の照会結果をキャッシュする時間(秒)。既定値は 3600。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Korean Patent Status — 특허 존속 여부 판정 のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server Korean Patent Status — 특허 존속 여부 판정 を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "korean-patent": { "command": "npx", "args": [ "-y", "korean-patent-mcp" ], "env": { "KIPRIS_SERVICE_KEY": "your-value", "DATA_GO_KR_SERVICE_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korean Patent Status — 특허 존속 여부 판정 のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Korean Patent Status — 특허 존속 여부 판정 の設定で KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Korean Patent Status — 특허 존속 여부 판정 を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Korean Patent Status — 특허 존속 여부 판정 を使っていると言うか、回答に Korean Patent Status — 특허 존속 여부 판정 のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
KIPRIS_CACHE_TTL 任意。同じ番号の照会結果をキャッシュする時間(秒)。既定値は 3600。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Korean Patent Status — 특허 존속 여부 판정 のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server Korean Patent Status — 특허 존속 여부 판정 を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "korean-patent": { "type": "stdio", "command": "npx", "args": [ "-y", "korean-patent-mcp" ], "env": { "KIPRIS_SERVICE_KEY": "your-value", "DATA_GO_KR_SERVICE_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korean Patent Status — 특허 존속 여부 판정 のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
Korean Patent Status — 특허 존속 여부 판정 の設定で KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Korean Patent Status — 특허 존속 여부 판정 を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Korean Patent Status — 특허 존속 여부 판정 を使っていると言うか、回答に Korean Patent Status — 특허 존속 여부 판정 のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
KIPRIS_CACHE_TTL 任意。同じ番号の照会結果をキャッシュする時間(秒)。既定値は 3600。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code
claude mcp add --scope user korean-patent --env KIPRIS_SERVICE_KEY=your-value --env DATA_GO_KR_SERVICE_KEY=your-value -- npx -y korean-patent-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"korean-patent": {
"command": "npx",
"args": [
"-y",
"korean-patent-mcp"
],
"env": {
"KIPRIS_SERVICE_KEY": "your-value",
"DATA_GO_KR_SERVICE_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"korean-patent": {
"command": "npx",
"args": [
"-y",
"korean-patent-mcp"
],
"env": {
"KIPRIS_SERVICE_KEY": "your-value",
"DATA_GO_KR_SERVICE_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"korean-patent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"korean-patent-mcp"
],
"env": {
"KIPRIS_SERVICE_KEY": "your-value",
"DATA_GO_KR_SERVICE_KEY": "your-value"
}
}
}
}KIPRIS_SERVICE_KEY 秘密 必須 envDATA_GO_KR_SERVICE_KEY 秘密 必須 envKIPRIS_CACHE_TTL env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
npm: korean-patent-mcpこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント didrod205 で確認済みです
コードの最終更新:2 か月前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に korean-patent-mcp@1.3.6 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/didrod205-korean-patent-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:KIPRIS_SERVICE_KEY, DATA_GO_KR_SERVICE_KEY
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は2 か月前、最新バージョン(1.3.6)がレジストリに届いたのは2 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| これ Korean Patent Status — 특허 존속 여부 판정 | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| ライセンス | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
특허 출원번호나 기술 설명을 넣으면, 그 권리가 지금 살아있는지를 판정해서 돌려주는 MCP 서버.
KIPRIS Plus 기반. 도구는 3개다. 늘리지 않는다.
npx korean-patent-mcp@latest setup
도구 3개의 실제 실행 결과입니다. 재현한 화면이 아니라 KIPRIS·등록원부에서 받은 값입니다.
LLM에게 특허를 물으면 세 가지 방식으로 틀린다.
| 거짓말 | 이 서버가 잡는 법 |
|---|---|
| 없는 특허번호를 지어낸다 | exists: false |
| 실재하는 번호에 엉뚱한 명칭을 붙인다 | title_match: "mismatch" |
| 20년 전에 소멸한 특허를 유효하다고 쓴다 | alive: false |
세 번째가 제일 위험하다. 번호도 실재하고 명칭도 맞는데, 그 권리는 이미 죽어 있다. 검색만 하는 도구는 이걸 절대 못 잡는다. 그래서 이 서버는 검색 결과에도 `alive`를 강제로 붙인다.
설치하고 나면 클라이언트에서 그냥 한국어로 물으면 된다.
"10-2019-0123456 이 특허 아직 살아있어?"
"이 IR 자료에 적힌 특허번호들 진짜인지 전부 확인해줘" *(문서를 그대로 붙여넣기)*
"무선 충전 코일 정렬 관련 국내 특허 중에 아직 유효한 것만 찾아줘"
rights_alive(number)번호 하나 → 생사 판정. 이 서버의 존재 이유.
{
"alive": false, "status": "소멸(연차료 불납)", "stage": "소멸", "number": "10-2000-0012345", "title": "카세트 테이프 권취 장치", "holder": "다라산업", "expiry": "2020-05-10", "expiry_estimated": true, "raw_status": "소멸(연차료 불납)", "basis": "상태 문자열 \"소멸(연차료 불납)\"에서 소멸 신호 검출", "warnings": ["holder는 출원인 기준입니다. 등록 후 권리가 양도되었으면 현재 권리자와 다를 수 있습니다."], "latest_event": { "date": "2020-08-01", "description": "연차료 불납에 의한 소멸" }, "checked_at": "2026-09-04", "source_url": "https://www.kipris.or.kr/khome/search/searchResult.do?tab=patent&query=10-2000-0012345" }
`alive`만 보지 말고 `stage`도 보라. alive: false에는 정반대 두 가지가 섞여 있다.
| stage | alive | 뜻 |
|---|---|---|
등록유효 | true | 지금 행사 가능한 권리 |
소멸 | false | 있었는데 죽었다. 등록원부를 붙이면 연차료 불납인지 존속기간 만료인지까지 갈린다 |
출원종료 | false | 등록 못 하고 끝났다 (거절·취하·포기) |
출원계속 | false | 아직 안 태어났다. 심사 중이라 장래 등록될 수 있다 |
불명 | false | 상태값을 해석 못 했다. raw_status를 직접 보라 |
FTO 관점에서 소멸은 안전 신호이고 출원계속은 위험 신호다. 둘 다 alive: false지만 의미가 반대다.
verify_citations(text)LLM 답변을 통째로 넣으면 인용된 특허번호를 전부 검증한다.
{
"all_clear": false, "total_found": 3, "checked": 3, "citations": [ { "number": "10-2019-0123456", "cited_as": "10-2019-0123456", "exists": true, "claimed_title": "인공지능 기반 신약 후보물질 탐색 방법", "actual_title": "무선 충전 장치 및 그 제어 방법", "title_match": "mismatch", "title_similarity": 0.04, "alive": true, "verdict": "title_mismatch", "note": "명칭 불일치. 인용: \"인공지능 기반 신약 후보물질 탐색 방법\" / 실제: \"무선 충전 장치 및 그 제어 방법\"" } ], "warnings": ["명칭 불일치 1건: 10-2019-0123456 — 번호는 실재하나 다른 발명입니다."], "summary": "인용 3건 중 1건에 문제가 있습니다." }
verdict는 ok / dead / title_mismatch / not_found / pending / unknown 중 하나다.
search_ip(query, ...)검색. 단, 모든 결과에 `alive`가 붙는다. 죽은 권리는 display: "dimmed"로 표시되고 뒤로 정렬된다.
{
"query": "무선 충전 코일 정렬", "total_matched": 412, "inspected": 20, "alive_in_inspected": 7, "dead_in_inspected": 13, "coverage_warning": "전체 412건 중 20건만 판정했습니다. ...", "results": [ { "alive": true, "display": "normal", "status": "등록유효 (만료예정 2039-03-14)", "number": "10-2019-0123456", "…": "…" }, { "alive": false, "display": "dimmed", "status": "소멸(존속기간 만료)", "number": "10-2001-0009999", "…": "…" } ], "notes": ["생사 판정은 검색 결과의 등록상태 문자열에 근거합니다. 특정 건을 근거로 삼기 전에 그 번호로 rights_alive를 호출해 확정하세요."] }
alive_only: true를 주면 살아있는 것만 나온다.
집계는 `inspected` 기준이지 `total_matched` 기준이 아니다. 전체를 다 보지 못했으면
coverage_warning이 채워진다.alive_in_inspected: 0을 "그런 유효 특허가 없다"로
읽으면 안 된다 — 21,060건 중 10건만 본 결과일 수 있다.
KIPRIS Plus에서 직접 신청한다. 공공데이터포털(data.go.kr)이 아니다.
https://plus.kipris.or.kr → 회원가입 → 서비스 신청 → "특허·실용 공개·등록공보" (국내 IP데이터 > 공보 > 특허·실용, REST)
발급된 ServiceKey 를 KIPRIS_SERVICE_KEY 에 넣는다. 무료 이용자 구간이 있다. 초당 호출 제한은 무료 50회 / 유료 75회다.
공공데이터포털에서 찾지 마세요. 포털의 KIPRISPlus 항목들은 "활용신청"이 아니라
"제공처 바로가기" 로 KIPRIS Plus를 가리키기만 합니다. 예전에 있던
data.go.kr/data/15058788항목은 현재 폐지(404)됐습니다.
포털에서 직접 신청 가능한 건 별개 API인 등록원부 실시간 조회(
15124946) 쪽입니다.
다른 KIPRIS 서비스 키로는 동작하지 않습니다. KIPRIS에는 등록사항·해외특허·심판 등
서비스가 여러 개 있고 신청은 각각 따로 승인됩니다. 이 서버는
patUtiModInfoSearchSevice
하나만 호출하므로 위 서비스를 신청해야 합니다.
엉뚱한 서비스 키를 넣으면 모든 호출이
SERVICE KEY IS NOT REGISTERED로 실패합니다.
호출 한도보다 호출량을 먼저 신경 쓰세요. verify_citations가 번호 20개를 검증하면 그것만으로 20회입니다. 서버는 같은 번호를 프로세스 내에서 1시간 캐시하고 (KIPRIS_CACHE_TTL로 조절), 동시 요청을 3개로 묶어 초당 제한에 여유를 둡니다.
npx korean-patent-mcp@latest setup
키를 프롬프트로 받아 실제 호출로 검증한 뒤 선택한 클라이언트 설정 파일에 등록한다. Claude Desktop / Claude Code / Cursor / VS Code / Windsurf / Gemini CLI / Zed 지원.
설치 전에 MCP 클라이언트를 완전히 종료하세요(Cmd+Q).
Claude Desktop은
claude_desktop_config.json을 자기 preferences 저장소로도 씁니다.
켜진 채로 고치면 앱이 종료할 때 덮어써서 방금 추가한 서버가 조용히 사라집니다.
setup이 실행 중인 클라이언트를 감지해 막아주지만, 수동 설정 시에는 직접 확인하세요.
최초 실행은 30초쯤 걸립니다.
npx가 패키지를 받는 시간입니다(2회차부터 1초 내외).
그 사이 "연결 실패"로 보이면 클라이언트를 한 번 더 재시작하세요.
매번 빠르게 뜨길 원하면
npm i -g korean-patent-mcp후command를
korean-patent-mcp로 바꾸면 됩니다.
{
"mcpServers": { "korean-patent": { "command": "npx", "args": ["-y", "korean-patent-mcp@latest"], "env": { "KIPRIS_SERVICE_KEY": "여기에-키" } } } }
셋 중 하나. 위에서부터 권장한다.
1) MCP 클라이언트에서 쓸 때 — `setup`이 알아서 넣는다
npx korean-patent-mcp@latest setup
클라이언트 설정 파일의 env 블록에 기록하고 파일 권한을 600으로 조인다.
2) 여러 곳에서 공용으로 — 홈 설정 파일
mkdir -p ~/.config/korean-patent-mcp
printf 'KIPRIS_SERVICE_KEY=발급받은키\n' > ~/.config/korean-patent-mcp/.env chmod 600 ~/.config/korean-patent-mcp/.env
MCP 클라이언트는 서버를 임의의 작업 디렉토리에서 띄우므로, 프로젝트 .env보다 이 경로가 안정적이다. 서버가 시작할 때 자동으로 읽는다.
3) 이 저장소에서 개발할 때 — 프로젝트 `.env`
cp .env.example .env && chmod 600 .env
.gitignore에 이미 들어 있어 커밋되지 않는다.
우선순위는 실제 환경변수 > 프로젝트 `.env` > 홈 `.env` 다. 일회성으로 다른 키를 쓰려면 그냥 앞에 붙이면 된다:
KIPRIS_SERVICE_KEY='다른키' npx korean-patent-mcp probe
~/.zshrc에export하는 방법도 되지만 권하지 않는다.
셸을 띄우는 모든 프로세스에 키가 노출되고, dotfiles를 저장소에 올리는 사람이 많다.
키를 이슈·PR·채팅에 붙여넣지 마세요. 노출됐으면 KIPRIS Plus 마이페이지에서 재발급하세요.
| 환경변수 | 기본값 | 설명 |
|---|---|---|
KIPRIS_SERVICE_KEY | (필수) | KIPRIS Plus ServiceKey. 위 3가지 방법 중 하나로 설정 |
KIPRIS_CACHE_TTL | 3600 | 응답 캐시 TTL(초) |
DATA_GO_KR_SERVICE_KEY | (선택) | 등록원부 API 키 — 연차료·확정 만료일 |
LEDGER_ENDPOINT | (선택) | 등록원부 오퍼레이션 URL (활용가이드 PDF 참조) |
KIPRIS_BASE_URL | KIPRIS Plus 공식 | 엔드포인트 오버라이드 |
기본 상태에서 rights_alive의 만료일은 출원일 + 법정 존속기간으로 계산한 추정치이고, 연차료 납부 여부는 확인되지 않는다. 등록원부 API를 붙이면 둘 다 확정된다.
| 기본 | 등록원부 연동 | |
|---|---|---|
expiry | 추정 (expiry_estimated: true) | 확정 (연장등록 반영) |
holder | 출원인 | 실제 등록권자 (양도 반영) |
annual_fee | null | { paid_year, paid_until } |
KIPRIS Plus와 별개 API다. 키도 신청도 따로 한다.
DATA_GO_KR_SERVICE_KEY = 일반 인증키(Decoding)이게 전부다. 엔드포인트는 기본값이 들어 있고, 번호의 권리구분을 보고 특허는 getPatentRegisterHistory로, 실용신안은 getUtilityModelHistory로 자동으로 나뉜다.
설정하면 이렇게 바뀐다:
{
"expiry": "2034-11-26", "expiry_estimated": false, "holder": "삼성전자주식회사", "annual_fee": { "paid_year": 6, "last_paid_date": "2026-03-27", "payment_count": 4 }, "sources": ["KIPRIS 서지상세", "등록원부"], "warnings": [] }
warnings가 빈 배열인 것에 주목. 추정치도 미확인 항목도 없으니 붙일 경고가 없다.
npx korean-patent-mcp probe --ledger 10-2245822
설정하지 않아도 서버는 그대로 동작한다. 등록원부는 부가정보라, 호출이 실패해도 생사 판정은 KIPRIS 서지정보만으로 나간다. 어떤 소스를 봤는지는 응답의 sources 필드에 적힌다.
probe — 데이터를 믿어도 되는지 먼저 확인이 서버 전체는 두 가지 전제 위에 서 있다. 하나라도 무너지면 코드가 아무리 좋아도 거짓말을 하게 된다.
이걸 눈으로 확인하지 말고 명령 하나로 판정한다.
KIPRIS_SERVICE_KEY='...' npx korean-patent-mcp probe
# 상태를 확실히 아는 번호로 재는 쪽이 훨씬 정확하다
npx korean-patent-mcp probe 10-2019-0123456 10-1234567
npx korean-patent-mcp probe --raw 10-2019-0123456
probe가 하는 일:
registerStatus, finalDisposal, applicationDate …)가 실제로 있는지 확인src/lib/status.ts에 추가하면 된다)src/lib/status.ts 하나에 모여 있다. 나머지는 전부 배관이다.
basis(판정 근거)와 warnings가 붙는다. 해석 못 한 상태값은 stage: "불명" + alive: false다 — 모르는 걸 살아있다고 하지 않는다.KIPRIS 문서가 명시한 registerStatus 값은 공개 · 등록 · 거절 · 무효 · 소멸 · 취하 · 포기 7개다. 7개 모두 규칙이 커버하며(kipris-fixture.test.ts에서 고정), 이 중 alive: true가 되는 값은 `등록` 하나뿐이다.
expiry_estimated: true면 출원일 + 법정 존속기간으로 계산한 값이다. 존속기간 연장등록(의약품·농약)이 있으면 실제 만료일은 더 뒤다.search_ip의 생사 판정은 검색 응답의 상태 문자열에만 근거한다. 특정 건을 근거로 삼기 전에 그 번호로 rights_alive를 다시 부르세요.30-·40- 번호는 명시적으로 거절한다.npm install
npm test # 93 tests npm run typecheck npm run build
src/ ├── index.ts 진입점 (stdio / setup / probe) ├── tool-registry.ts 도구 3개 등록 — 여기가 늘어나면 안 된다 ├── setup.ts 대화형 설치 (키 검증 포함) ├── probe.ts 응답 진단 — 기획 폐기 여부 판정 ├── lib/ │ ├── status.ts ★ 생사 판정 엔진. 이 프로젝트의 실체 │ ├── number.ts 번호 파싱·정규화·텍스트 추출 │ ├── kipris-client.ts KIPRIS Plus HTTP (재시도·캐시·오류 해석) │ ├── ledger-client.ts 등록원부 실시간 조회 (선택 — 연차료·확정 만료일) │ ├── title-match.ts 인용 명칭 ↔ 실제 명칭 대조 │ ├── xml.ts 의존성 없는 XML 추출 │ ├── cache.ts TTL 캐시 (호출량 방어) │ └── errors.ts 오류 → 도구 응답 └── tools/ ├── rights-alive.ts ├── verify-citations.ts └── search-ip.ts
상태값을 하나 더 알게 됐다면 src/lib/status.ts의 DEAD_PATTERNS / PENDING_PATTERNS에 추가하고 src/lib/status.test.ts에 케이스를 하나 넣으면 된다. probe가 모르는 상태값을 알려준다.
main에 푸시하면 CI가 Node 20.19/22/24에서 typecheck·test·build·패키지 검증을 돌린다.
릴리스를 만들면 npm에 자동 배포된다:
npm version patch && git push --follow-tags
gh release create "v$(node -p "require('./package.json').version")" --generate-notes
publish.yml이 릴리스 태그와 `package.json` 버전 일치를 강제한다. 로컬 버전과 배포 버전이 어긋나는 사고를 구조적으로 막는 게이트다.
인증은 Trusted Publishing(OIDC) 을 쓴다. NPM_TOKEN 시크릿이 없다 — npm granular token은 최대 90일이라 분기마다 만료되고 그때마다 배포가 조용히 깨진다. OIDC는 GitHub가 워크플로 실행마다 발급하는 단기 증명이라 갱신할 것도, 유출될 장기 비밀도 없다.
최초 1회만 npmjs.com > 패키지 > Settings > Trusted Publisher 에 등록한다:
| 항목 | 값 |
|---|---|
| Repository | didrod205/korean-patent-mcp |
| Workflow | publish.yml |
등록 전까지는 로컬에서 npm publish 하면 된다 (prepublishOnly가 빌드와 verify:package를 자동으로 돌려 빌드-버전 불일치를 막는다).
클라이언트 로그를 먼저 보세요. Claude Desktop은 ~/Library/Logs/Claude/mcp*.log 에 원인이 그대로 찍힙니다.
| 로그에 보이는 것 | 원인 | 해결 |
|---|---|---|
notarget No matching version found | 방금 배포된 버전을 @latest 가 가리키는데 레지스트리 전파가 끝나지 않음 | 몇 분 뒤 클라이언트를 다시 시작 |
| 아무 로그도 없음 | 클라이언트가 설정을 아직 안 읽음 | 완전 종료(Cmd+Q) 후 재시작 |
Server disconnected 만 반복 | 최초 실행 다운로드(30초) 중 타임아웃 | 재시작하면 캐시가 있어 1초 내에 뜸 |
KIPRIS_SERVICE_KEY 가 없습니다 | 설정의 env 가 비었음 | 아래 "설정이 사라졌습니다" 참조 |
mcpServers 에 넣었는데 없어졌다면, 클라이언트가 켜진 상태에서 파일을 고쳤을 가능성이 큽니다. Claude Desktop은 claude_desktop_config.json 을 자기 preferences 저장소로도 써서, 앱이 종료할 때 메모리 상태로 덮어씁니다. 완전히 종료한 뒤 다시 설정하세요. setup 은 실행 중인 클라이언트를 감지해 이 상황을 막습니다.