mcp_kipris

mcp_kipris

3.2

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๋ฅผ ํ™œ์šฉํ•œ ํŠนํ—ˆ ๊ฒ€์ƒ‰ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค.

๊ธฐ๋Šฅ

ํ•œ๊ตญ ํŠนํ—ˆ ๊ฒ€์ƒ‰

  1. ์ถœ์›์ธ ๊ฒ€์ƒ‰ (PatentApplicantSearchTool)

    • ์ถœ์›์ธ ์ด๋ฆ„์œผ๋กœ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ์ •๋ ฌ ๋ฐ ํ•„ํ„ฐ๋ง ์˜ต์…˜ ์ง€์›
  2. ํ‚ค์›Œ๋“œ ๊ฒ€์ƒ‰ (PatentFreeSearchTool)

    • ์ž์œ  ํ…์ŠคํŠธ๋กœ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ์ •๋ ฌ ๋ฐ ํ•„ํ„ฐ๋ง ์˜ต์…˜ ์ง€์›
  3. ์ถœ์›๋ฒˆํ˜ธ ๊ฒ€์ƒ‰ (PatentApplicationNumberSearchTool)

    • ์ถœ์›๋ฒˆํ˜ธ๋กœ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ์ƒ์„ธ ์ •๋ณด ์กฐํšŒ ๊ฐ€๋Šฅ
  4. ๊ถŒ๋ฆฌ์ž ๊ฒ€์ƒ‰ (PatentRighterSearchTool)

    • ๊ถŒ๋ฆฌ์ž ์ด๋ฆ„์œผ๋กœ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ์ •๋ ฌ ๋ฐ ํ•„ํ„ฐ๋ง ์˜ต์…˜ ์ง€์›
  5. ํŠนํ—ˆ ์ƒ์„ธ ์ •๋ณด ๊ฒ€์ƒ‰ (PatentDetailSearchTool)

    • ์ถœ์›๋ฒˆํ˜ธ๋กœ ํŠนํ—ˆ์˜ ์ƒ์„ธ ์ •๋ณด ์กฐํšŒ
  6. ํŠนํ—ˆ ์š”์•ฝ ์ •๋ณด ๊ฒ€์ƒ‰ (PatentSummarySearchTool)

    • ์ถœ์›๋ฒˆํ˜ธ๋กœ ํŠนํ—ˆ์˜ ์š”์•ฝ ์ •๋ณด ์กฐํšŒ

ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰

  1. ์ถœ์›์ธ ๊ฒ€์ƒ‰ (ForeignPatentApplicantSearchTool)

    • ์ถœ์›์ธ ์ด๋ฆ„์œผ๋กœ ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ๊ตญ๊ฐ€๋ณ„ ๊ฒ€์ƒ‰ ์ง€์›
  2. ์ถœ์›๋ฒˆํ˜ธ ๊ฒ€์ƒ‰ (ForeignPatentApplicationNumberSearchTool)

    • ์ถœ์›๋ฒˆํ˜ธ๋กœ ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ๊ตญ๊ฐ€๋ณ„ ๊ฒ€์ƒ‰ ์ง€์›
  3. ํ‚ค์›Œ๋“œ ๊ฒ€์ƒ‰ (ForeignPatentFreeSearchTool)

    • ์ž์œ  ํ…์ŠคํŠธ๋กœ ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰
    • ๊ตญ๊ฐ€๋ณ„ ๊ฒ€์ƒ‰ ์ง€์›
  4. ๊ตญ์ œ์ถœ์›๋ฒˆํ˜ธ ๊ฒ€์ƒ‰ (ForeignPatentInternationalApplicationNumberSearchTool)

    • ๊ตญ์ œ์ถœ์›๋ฒˆํ˜ธ๋กœ ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰
  5. ๊ตญ์ œ๊ณต๊ฐœ๋ฒˆํ˜ธ ๊ฒ€์ƒ‰ (ForeignPatentInternationalOpenNumberSearchTool)

    • ๊ตญ์ œ๊ณต๊ฐœ๋ฒˆํ˜ธ๋กœ ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰

์„ค์น˜ ๋ฐ ์‹คํ–‰

ํ™˜๊ฒฝ ์„ค์ •

  1. KIPRIS API ํ‚ค ์„ค์ •
export KIPRIS_API_KEY="your_api_key"
  1. ์˜์กด์„ฑ ์„ค์น˜
pip install -r requirements.txt

์‹คํ–‰ ๋ฐฉ๋ฒ•

  1. HTTP ์„œ๋ฒ„ ๋ชจ๋“œ
python -m mcp_kipris.sse_server --http --port 6274 --host 0.0.0.0
  1. 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๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•œ ์„ค์ •์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

์„ค์น˜ ๋ฐฉ๋ฒ•

  1. Python 3.12 ์ด์ƒ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
  2. ๊ฐ€์ƒํ™˜๊ฒฝ์„ ์ƒ์„ฑํ•˜๊ณ  ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค:
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# ๋˜๋Š”
.venv\Scripts\activate  # Windows
  1. ํ”„๋กœ์ ํŠธ๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค:
pip install -e .

API ์‚ฌ์šฉ ์˜ˆ์ œ

SSE ์—ฐ๊ฒฐ ์„ค์ •

  1. SSE ์—ฐ๊ฒฐ ๋ฐ ์„ธ์…˜ ID ๋ฐ›๊ธฐ:
curl -N http://localhost:6274/messages/

์‘๋‹ต ์˜ˆ์‹œ:

event: endpoint
data: /messages/?session_id=<์„ธ์…˜_ID>

๋„๊ตฌ ๋ชฉ๋ก ์กฐํšŒ

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

ํŠนํ—ˆ ๊ฒ€์ƒ‰ ์˜ˆ์ œ

  1. ์ถœ์›์ธ ๊ฒ€์ƒ‰ (์‚ผ์„ฑ์ „์ž์˜ ์ตœ๊ทผ ํŠนํ—ˆ 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
    }
  }'

์ง€์›ํ•˜๋Š” ๋„๊ตฌ ๋ชฉ๋ก

  1. ํ•œ๊ตญ ํŠนํ—ˆ ๊ฒ€์ƒ‰:

    • patent_applicant_search: ์ถœ์›์ธ ๊ธฐ์ค€ ๊ฒ€์ƒ‰
    • patent_keyword_search: ํ‚ค์›Œ๋“œ ๊ธฐ์ค€ ๊ฒ€์ƒ‰
    • patent_search: ์ถœ์›๋ฒˆํ˜ธ๋กœ ๊ฒ€์ƒ‰
    • patent_righter_search: ๊ถŒ๋ฆฌ์ž ๊ธฐ์ค€ ๊ฒ€์ƒ‰
    • patent_application_number_search: ์ถœ์›๋ฒˆํ˜ธ๋กœ ๊ฒ€์ƒ‰
    • patent_summary_search: ์ถœ์›๋ฒˆํ˜ธ๋กœ ์š”์•ฝ ์ •๋ณด ๊ฒ€์ƒ‰
    • patent_detail_search: ์ถœ์›๋ฒˆํ˜ธ๋กœ ์ƒ์„ธ ์ •๋ณด ๊ฒ€์ƒ‰
  2. ํ•ด์™ธ ํŠนํ—ˆ ๊ฒ€์ƒ‰:

    • 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

๊ธฐ์—ฌํ•˜๊ธฐ

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request