Naver OpenAPI를 쉽게 연동하는 방법: py-mcp-naver 사용기
오늘은 Naver OpenAPI를 간편하게 MCP(Model Context Protocol) 서버로 연결할 수 있는 프로젝트인 **py-mcp-naver**를 소개합니다.
블로그 검색, 뉴스 검색, 책 검색 등 다양한 Naver 서비스 API를 직접 다루고 싶은 분들께 딱 맞는 도구입니다.
https://github.com/pfldy2850/py-mcp-naver
py-mcp-naver란?
py-mcp-naver는 Naver OpenAPI를 기반으로 다양한 검색 기능을 제공하는 MCP 서버를 구축할 수 있게 해주는 Python 프로젝트입니다.
지원하는 기능은 다음과 같습니다:
-
블로그 검색
-
뉴스 검색
-
책 검색 및 상세 정보 조회
-
성인 콘텐츠 여부 판별
-
백과사전 검색
-
카페 글 검색
-
지식인 검색
-
지역 검색
-
맞춤법 검사
-
웹사이트 검색
-
이미지 검색
-
쇼핑 검색
-
문서 검색
이 모든 기능을 단 한 번의 설치로 바로 사용할 수 있습니다.
사전 준비
-
Naver OpenAPI 이용을 위해 먼저 애플리케이션을 등록해야 합니다.
여기에서 Naver OpenAPI에 등록하세요. -
등록 후 발급받은 Client ID와 Client Secret을 준비합니다.
설치 방법
Server 설치는 아래 명령어로만 제대로 동작합니다!
fastmcp install mcp_naver/server.py -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>
(※ 다른 방식은 정상 동작하지 않을 수 있으니 주의하세요!)
사용 가능한 주요 기능들
블로그 검색
search_blog(query: str, display: int = 10, start: int = 1, sort: str = "sim")
뉴스 검색
search_news(query: str, display: int = 10, start: int = 1, sort: str = "sim")
책 검색
search_book(query: str, display: int = 10, start: int = 1, sort: str = "sim")
고급 책 검색
get_book_adv(query: str = None, d_titl: str = None, d_isbn: str = None, ...)
성인 콘텐츠 여부 검사
adult_check(query: str)
백과사전 검색
search_encyc(query: str, display: int = 10, start: int = 1)
카페 글 검색
search_cafe_article(query: str, display: int = 10, start: int = 1, sort: str = "sim")
지식인 검색
search_kin(query: str, display: int = 10, start: int = 1, sort: str = "sim")
지역 검색
search_local(query: str, display: int = 10, start: int = 1, sort: str = "random")
맞춤법 검사
fix_spelling(query: str)
웹 검색
search_webkr(query: str, display: int = 10, start: int = 1)
이미지 검색
search_image(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = "all")
쇼핑 검색
search_shop(query: str, display: int = 10, start: int = 1, sort: str = "sim", filter: str = None, exclude: str = None)
문서 검색
search_doc(query: str, display: int = 10, start: int = 1)마치며
py-mcp-naver를 이용하면 Naver OpenAPI를 훨씬 더 쉽고 빠르게 사용할 수 있습니다.
0 댓글