mcp_kipris
If you are the rightful owner of mcp_kipris and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
MCP KIPRIS is a patent search tool utilizing the KIPRIS API for searching Korean and foreign patents.
MCP KIPRIS
KIPRIS(ํ๊ตญํนํ์ ๋ณด์) API๋ฅผ ํ์ฉํ ํนํ ๊ฒ์ ๋๊ตฌ์ ๋๋ค.
๊ธฐ๋ฅ
ํ๊ตญ ํนํ ๊ฒ์
-
์ถ์์ธ ๊ฒ์ (PatentApplicantSearchTool)
- ์ถ์์ธ ์ด๋ฆ์ผ๋ก ํนํ ๊ฒ์
- ์ ๋ ฌ ๋ฐ ํํฐ๋ง ์ต์ ์ง์
-
ํค์๋ ๊ฒ์ (PatentFreeSearchTool)
- ์์ ํ ์คํธ๋ก ํนํ ๊ฒ์
- ์ ๋ ฌ ๋ฐ ํํฐ๋ง ์ต์ ์ง์
-
์ถ์๋ฒํธ ๊ฒ์ (PatentApplicationNumberSearchTool)
- ์ถ์๋ฒํธ๋ก ํนํ ๊ฒ์
- ์์ธ ์ ๋ณด ์กฐํ ๊ฐ๋ฅ
-
๊ถ๋ฆฌ์ ๊ฒ์ (PatentRighterSearchTool)
- ๊ถ๋ฆฌ์ ์ด๋ฆ์ผ๋ก ํนํ ๊ฒ์
- ์ ๋ ฌ ๋ฐ ํํฐ๋ง ์ต์ ์ง์
-
ํนํ ์์ธ ์ ๋ณด ๊ฒ์ (PatentDetailSearchTool)
- ์ถ์๋ฒํธ๋ก ํนํ์ ์์ธ ์ ๋ณด ์กฐํ
-
ํนํ ์์ฝ ์ ๋ณด ๊ฒ์ (PatentSummarySearchTool)
- ์ถ์๋ฒํธ๋ก ํนํ์ ์์ฝ ์ ๋ณด ์กฐํ
ํด์ธ ํนํ ๊ฒ์
-
์ถ์์ธ ๊ฒ์ (ForeignPatentApplicantSearchTool)
- ์ถ์์ธ ์ด๋ฆ์ผ๋ก ํด์ธ ํนํ ๊ฒ์
- ๊ตญ๊ฐ๋ณ ๊ฒ์ ์ง์
-
์ถ์๋ฒํธ ๊ฒ์ (ForeignPatentApplicationNumberSearchTool)
- ์ถ์๋ฒํธ๋ก ํด์ธ ํนํ ๊ฒ์
- ๊ตญ๊ฐ๋ณ ๊ฒ์ ์ง์
-
ํค์๋ ๊ฒ์ (ForeignPatentFreeSearchTool)
- ์์ ํ ์คํธ๋ก ํด์ธ ํนํ ๊ฒ์
- ๊ตญ๊ฐ๋ณ ๊ฒ์ ์ง์
-
๊ตญ์ ์ถ์๋ฒํธ ๊ฒ์ (ForeignPatentInternationalApplicationNumberSearchTool)
- ๊ตญ์ ์ถ์๋ฒํธ๋ก ํด์ธ ํนํ ๊ฒ์
-
๊ตญ์ ๊ณต๊ฐ๋ฒํธ ๊ฒ์ (ForeignPatentInternationalOpenNumberSearchTool)
- ๊ตญ์ ๊ณต๊ฐ๋ฒํธ๋ก ํด์ธ ํนํ ๊ฒ์
์ค์น ๋ฐ ์คํ
ํ๊ฒฝ ์ค์
- KIPRIS API ํค ์ค์
export KIPRIS_API_KEY="your_api_key"
- ์์กด์ฑ ์ค์น
pip install -r requirements.txt
์คํ ๋ฐฉ๋ฒ
- HTTP ์๋ฒ ๋ชจ๋
python -m mcp_kipris.sse_server --http --port 6274 --host 0.0.0.0
- stdio ์๋ฒ ๋ชจ๋
python -m mcp_kipris.server
์ง์ํ๋ ๊ตญ๊ฐ ์ฝ๋
- US: ๋ฏธ๊ตญ
- EP: ์ ๋ฝ
- WO: PCT
- JP: ์ผ๋ณธ
- PJ: ์ผ๋ณธ์๋ฌธ์ด๋ก
- CP: ์ค๊ตญ
- CN: ์ค๊ตญํนํ์๋ฌธ์ด๋ก
- TW: ๋๋ง์๋ฌธ์ด๋ก
- RU: ๋ฌ์์
- CO: ์ฝ๋กฌ๋น์
- SE: ์ค์จ๋ด
- ES: ์คํ์ธ
- IL: ์ด์ค๋ผ์
์ ๋ ฌ ์ต์
- PD: ๊ณต๊ณ ์ผ์
- AD: ์ถ์์ผ์
- GD: ๋ฑ๋ก์ผ์
- OPD: ๊ณต๊ฐ์ผ์
- FD: ๊ตญ์ ์ถ์์ผ์
- FOD: ๊ตญ์ ๊ณต๊ฐ์ผ์
- RD: ์ฐ์ ๊ถ์ฃผ์ฅ์ผ์
ํนํ ์ํ ์ฝ๋
- A: ๊ณต๊ฐ
- C: ์ ์ ๊ณต๊ฐ
- F: ๊ณต๊ณ
- G: ์ ์ ๊ณต๊ณ
- I: ๋ฌดํจ๊ณต๊ณ
- J: ์ทจ์๊ณต๊ณ
- R: ์ฌ๊ณต๊ณ
Claude ์ค์
Claude๋ฅผ ์ฌ์ฉํ๊ธฐ ์ํ ์ค์ ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
์ค์น ๋ฐฉ๋ฒ
- Python 3.12 ์ด์์ด ํ์ํฉ๋๋ค.
- ๊ฐ์ํ๊ฒฝ์ ์์ฑํ๊ณ ํ์ฑํํฉ๋๋ค:
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# ๋๋
.venv\Scripts\activate # Windows
- ํ๋ก์ ํธ๋ฅผ ์ค์นํฉ๋๋ค:
pip install -e .
API ์ฌ์ฉ ์์
SSE ์ฐ๊ฒฐ ์ค์
- SSE ์ฐ๊ฒฐ ๋ฐ ์ธ์ ID ๋ฐ๊ธฐ:
curl -N http://localhost:6274/messages/
์๋ต ์์:
event: endpoint
data: /messages/?session_id=<์ธ์
_ID>
๋๊ตฌ ๋ชฉ๋ก ์กฐํ
curl http://localhost:6274/tools | jq .
ํนํ ๊ฒ์ ์์
- ์ถ์์ธ ๊ฒ์ (์ผ์ฑ์ ์์ ์ต๊ทผ ํนํ 5๊ฑด):
curl -X POST "http://localhost:6274/messages/?session_id=<์ธ์
_ID>" \
-H "Content-Type: application/json" \
-d '{
"type": "tool",
"name": "patent_applicant_search",
"args": {
"applicant": "์ผ์ฑ์ ์",
"docs_count": 5,
"desc_sort": true
}
}'
์ง์ํ๋ ๋๊ตฌ ๋ชฉ๋ก
-
ํ๊ตญ ํนํ ๊ฒ์:
patent_applicant_search
: ์ถ์์ธ ๊ธฐ์ค ๊ฒ์patent_keyword_search
: ํค์๋ ๊ธฐ์ค ๊ฒ์patent_search
: ์ถ์๋ฒํธ๋ก ๊ฒ์patent_righter_search
: ๊ถ๋ฆฌ์ ๊ธฐ์ค ๊ฒ์patent_application_number_search
: ์ถ์๋ฒํธ๋ก ๊ฒ์patent_summary_search
: ์ถ์๋ฒํธ๋ก ์์ฝ ์ ๋ณด ๊ฒ์patent_detail_search
: ์ถ์๋ฒํธ๋ก ์์ธ ์ ๋ณด ๊ฒ์
-
ํด์ธ ํนํ ๊ฒ์:
foreign_patent_applicant_search
: ์ถ์์ธ ๊ธฐ์ค ๊ฒ์foreign_patent_application_number_search
: ์ถ์๋ฒํธ๋ก ๊ฒ์foreign_patent_free_search
: ์์ ํ ์คํธ ๊ฒ์foreign_patent_international_application_number_search
: ๊ตญ์ ์ถ์๋ฒํธ๋ก ๊ฒ์foreign_patent_international_open_number_search
: ๊ตญ์ ๊ณต๊ฐ๋ฒํธ๋ก ๊ฒ์
์๋ต ํ์
๋ชจ๋ API ์๋ต์ JSON ํ์์ผ๋ก ๋ฐํ๋๋ฉฐ, ๋ค์๊ณผ ๊ฐ์ ๊ตฌ์กฐ๋ฅผ ๊ฐ์ง๋๋ค:
[
{
"type": "text",
"text": "๊ฒ์ ๊ฒฐ๊ณผ ํ
์คํธ",
"metadata": null
}
]
๋ก๊น
์๋ฒ๋ ๊ธฐ๋ณธ์ ์ผ๋ก DEBUG ๋ ๋ฒจ์ ๋ก๊น ์ ์ ๊ณตํฉ๋๋ค. ๋ก๊ทธ์์ ๋ค์๊ณผ ๊ฐ์ ์ ๋ณด๋ฅผ ํ์ธํ ์ ์์ต๋๋ค:
- ๋๊ตฌ ํธ์ถ ์์/์๋ฃ ์๊ฐ
- ๋๊ตฌ ์คํ ์์ ์๊ฐ
- ์ค๋ฅ ๋ฐ์ ์ ์์ธ ์ ๋ณด
๋ผ์ด์ ์ค
MIT License
๊ธฐ์ฌํ๊ธฐ
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request