쉬운 설명
AI 챗봇에게 "이 블로그에서 관련 글 좀 찾아줘"라고 부탁했을 때, 검색엔진을 거치지 않고도 AI가 블로그 내부를 직접 탐색해 정확한 글과 원문 링크까지 찾아준다면 정말 편리하겠죠?
이번 글에서 소개해 드릴 프로젝트가 바로 이 아이디어를 실제로 구현한 이야기입니다. 블로그의 다양한 글을 AI가 바로 읽고 활용할 수 있는 '도구 상자' 형태로 차곡차곡 담아, 누구나 손쉽게 설치해 쓸 수 있는 패키지로 배포했거든요. 쉽게 말해, AI 옆에 '블로그 전용 사서'를 한 명 붙여준 셈이라고 이해하시면 됩니다.
요약
이 프로젝트는 기술 블로그의 공개 글들을 MCP(Model Context Protocol) 규격에 맞춰 목록 조회, 검색, 본문 조회가 가능하도록 '읽기 전용 서버'로 구축하고, 이를 Python 패키지(aiarchitect-blog-mcp)로 만들어 PyPI에 배포한 사례입니다.
2026년 8월 기준 블로그 전체 글은 78편이지만, 꼼꼼한 검증을 통과한 69편만 패키지에 포함된 점이 특징인데요. 단순히 글을 모아 배포한 것에 그치지 않고, URL이 정식 게시글인지, 미공개 원고가 유출되지는 않는지, 잘못된 입력값이 들어와도 서버가 안정적으로 유지되는지 등을 철저히 검증했습니다.
이 과정이 중요한 이유는 AI 에이전트가 검색엔진의 색인을 기다릴 필요 없이 콘텐츠를 정확하게 탐색하고, 답변에 정식 원문 링크까지 명확히 남길 수 있게 되기 때문입니다. 검색 기능은 제목, 태그, 설명, 본문에 각각 다른 가중치를 부여해 항상 일관된 결과를 얻도록 결정적으로 설계했습니다. 또한 본문을 불러올 때는 글 앞뒤에 정식 원문 URL을 반드시 붙여 출처가 분명히 드러나도록 했죠.
이러한 방식은 개인 블로그는 물론, 공개 문서나 FAQ, 릴리스 노트처럼 재배포 권한이 명확한 다양한 텍스트 자료에도 그대로 적용할 수 있습니다.
활용 포인트
개발자라면 개인 기술 블로그나 사내 공개 문서를 동일한 방식으로 패키징해 볼 수 있습니다. uv나 hatchling으로 프로젝트를 구성하고, 글 본문과 인덱스를 패키지 내 data 폴더에 함께 넣어 배포해 보세요. 이렇게 하면 사용하는 사람은 별도의 원본 저장소 없이 fastmcp 같은 런타임만으로 쉽게 서버를 실행할 수 있습니다. Claude Code 환경에서는 uvx 명령어 한 줄로 등록할 수 있고, Claude Desktop이나 Cursor처럼 JSON 설정을 사용하는 클라이언트라면 설정 파일에 패키지명만 추가해 주면 끝납니다.
기획자나 콘텐츠 운영자라면 이러한 구조를 참고해서 AI가 자사의 공개 콘텐츠를 효율적으로 탐색하고 답변에 정확히 활용할 수 있도록 시스템을 구상해 보실 수 있습니다.
주의 사항
-
미공개 원고 유출 방지: 공개해도 되는 정식 게시글만 포함되었는지 사전에 철저히 확인해야 합니다.
-
예외 처리 및 서버 안정성: 사용자나 AI가 이상한 입력값을 보내더라도 서버가 죽지 않도록 예외 처리를 꼼꼼하게 구성해야 합니다.
-
재배포 권한 확인: 패키지로 배포하기 전에 포함되는 텍스트 자료의 재배포 권한이 명확한지 점검해 주세요.
자체 검증
-
전체 78편의 글 중 엄격한 검증 기준을 통과한 69편만 패키지에 포함시켜 안정성을 확보했습니다.
-
정식 게시글 URL 검증 및 예외 입력값 테스트를 거쳐 서버가 안정적으로 작동함을 확인했습니다.
태그
#MCP #ModelContextProtocol #Python #PyPI #aiarchitect_blog_mcp #AI에이전트 #기술블로그
원문
https://aiarchitect.tistory.com/63
https://github.com/aiarchitecturedev/aiarchitect-blog-mcp
https://aiarchitect.tistory.com/68