파이썬으로 뚝딱! 가장 쉬운 MCP 서버, FastMCP 3.0

💡 한줄 요약: 복잡한 설정 없이 파이썬 데코레이터 하나로 MCP 서버를 만든다고? FastMCP 3.0이 출시됐어. 핫 리로딩부터 디버깅까지, 이제 AI 에이전트 도구 개발도 웹 개발처럼 쉬워지는 거야.

🤔 이게 뭔데?

MCP(Model Context Protocol)가 요즘 핫하잖아. Claude 같은 AI 모델이 내 데이터나 툴에 접근하게 해주는 표준 프로토콜인데, 사실 이거 처음부터 짜려면 은근히 귀찮거든.

FastMCP 3.0은 이름 그대로 이걸 '엄청 빠르게' 만들 수 있게 해주는 파이썬 프레임워크야. FastAPI 써본 적 있어? 딱 그 느낌이야. @mcp.tool() 데코레이터만 붙이면 그 함수가 바로 AI가 쓸 수 있는 도구가 되는 마법이지.

단순히 쉬운 것뿐만 아니라, 프로덕션 레벨에서 필요한 기능들을 꽉 채워서 나왔어. 개발할 때 서버 껐다 켰다 할 필요 없는 '핫 리로딩', 이미지 같은 바이너리 데이터 처리, 그리고 에러 났을 때 어디가 문제인지 보여주는 대시보드까지. 이제 "MCP 서버 만드는 게 어려워서 못하겠어요"라는 핑계는 안 통할 것 같네.

📌 핵심 정리

• 데코레이터 기반: FastAPI처럼 직관적인 코드로 MCP 서버/클라이언트 개발 가능
• 스마트한 기능: 복잡한 데이터(이미지 등)와 긴 작업 처리(Long contexts)도 지원
• 개발자 경험(DX): 코드 수정하면 바로 반영되는 핫 리로딩 & 내장 디버깅 툴
• 다재다능: 단순 툴 제공을 넘어 데이터 리소스 연결, 프롬프트 템플릿 관리까지
• 오픈소스: 누구나 무료로 쓰고 기여할 수 있음

MAX5의 생각 🎯

👨‍💻 바이브 코딩 레시피

FastMCP로 '내 로컬 파일 검색기'를 3분 만에 만들어보자. Claude에게 이렇게 시켜봐.

프롬프트:

"FastMCP 라이브러리를 사용해서 로컬 폴더의 마크다운 파일을 검색하는 MCP 서버를 만들어줘.

1. search_notes(query: str) 함수를 만들고 @mcp.tool로 감싸.
2. fd나 grep 명령어를 파이썬 subprocess로 실행해서 결과를 리턴하게 해.
3. mcp-inspector로 테스트하는 방법도 주석으로 달아줘."

이렇게 만든 서버를 Claude Desktop 앱 설정(claude_desktop_config.json)에 등록하면, 이제 Claude가 내 컴퓨터 속 노트를 읽고 대답해줄 수 있게 되는 거야.

💸 사이드 프로젝트 아이디어

"SaaS 연동 전용 MCP 에이전트" 슬랙, 노션, 지라 같은 툴들은 API가 다 제각각이라 연동하기 힘들잖아. FastMCP로 이 API들을 통일된 MCP 인터페이스로 감싸서(Wrapper) 제공하는 거야. "슬랙에서 안 읽은 메시지 요약해줘" 같은 요청을 처리하는 서버를 만들어서 배포해보면 어떨까? 기업 내부용 AI 도입할 때 필수적인 미들웨어가 될 수도 있어.