I Built 3 MCP Servers for AI Agents — Here's How They Work

개요

MCP(Model Context Protocol) 서버는 AI 에이전트가 외부 도구와 데이터 소스를 통합된 인터페이스를 통해 활용할 수 있도록 하는 오픈 표준으로, 현재 웹 검색, 코드 리뷰 자동화, 문서 지능 기능을 제공하는 세 가지 서버가 개발 및 배포되었습니다.

주요 내용

* MCP(Model Context Protocol)란?
* AI 클라이언트(Claude Desktop, Cursor, VS Code with Cline 등)와 다양한 도구 또는 데이터 소스를 연결하는 USB-C와 유사한 AI용 오픈 표준 프로토콜입니다.
* 세 가지 MCP 서버 구현:
* 웹 검색 MCP 서버 (uvx crewai-web-search-mcp):
* web_search(query): Google/SerpAPI를 통해 검색 결과를 반환합니다.
* extract_content(url): 웹 페이지의 텍스트 내용을 추출합니다.
* 활용 사례: 최신 이벤트 정보 검색, 경쟁사 조사, 문서 내용 추출, 실시간 사실 검증 등
* 코드 리뷰 자동화 MCP (uvx code-review-automation):
* review_code(diff): 코드 변경 사항에 대한 버그, 보안 문제, 안티 패턴, 스타일 위반 등을 분석합니다.
* check_quality(path): 정적 분석을 수행하여 코드 품질 보고서를 생성합니다.
* analyze_pr(diff): 변경된 내용, 위험 요소, 제안 사항 등을 포함한 구조화된 PR 리뷰를 생성합니다.
* 활용 사례: PR diff를 붙여 즉각적인 코드 리뷰 수행, 프로덕션 배포 전 문제점 탐지
* 문서 지능 서버 (uvx document-intelligence-server):
* extract_document(path): PDF, 스캔 문서, 이미지에서 OCR 및 텍스트를 추출합니다.
* classify_document(path): 문서 유형(송장, 보고서, 계약서, 기사 등)을 식별합니다.
* summarize_document(path): 추출된 내용을 기반으로 구조화된 요약을 생성합니다.
* 활용 사례: PDF 문서 처리, 스캔된 양식에서 데이터 추출, 긴 보고서 요약
* 비용 및 사용:
* 세 가지 서버는 통합된 크레딧 시스템을 사용합니다.
* 무료 티어는 하루 50회의 호출을 제공하며, 별도의 키가 필요 없습니다.
* 유료 티어(Starter, Pro)는 더 많은 크레딧을 제공하며, Gumroad에서 크레딧을 구매하고 MCP_LICENSE_KEY를 설정하면 모든 제한이 해제됩니다.
* 크레딧은 일회성 구매이며 만료되지 않습니다.
* 기술 스택:
* 서버: Python + FastMCP
* 결제: FastAPI + PostgreSQL (오픈 소스, 자체 호스팅 가능)
* 인증: Gumroad 라이선스 키 검증
* 배포: PyPI, GitHub, HuggingFace, Gumroad, MCP 레지스트리
* 오픈 소스: 결제 백엔드 API 또한 오픈 소스로 공개되어 있습니다.

시사점

MCP 서버의 등장은 AI 에이전트가 외부 리소스를 더욱 효율적이고 통합적으로 활용할 수 있는 가능성을 보여주며, 개발자가 다양한 AI 기반 애플리케이션을 쉽게 구축하고 배포할 수 있도록 지원합니다.