💡 한줄 요약: 파이썬 데코레이터만으로 복잡한 설정 없이 순식간에 MCP 서버를 구축할 수 있는 FastMCP가 3.0으로 업데이트됐다. 이미지 처리, 컨텍스트 관리까지 더 강력해졌다!
🤔 이게 뭔데?
Claude의 MCP(Model Context Protocol) 서버를 만들고 싶은데, 설정 파일 만지느라 시간 다 보내고 있다면 주목해. FastMCP는 이름 그대로 진짜 빠르게 MCP 서버를 만들 수 있게 해주는 파이썬 라이브러리야.
FastAPI 써본 사람? 느낌 딱 올 거야. 함수 위에 @mcp.tool()만 붙이면 바로 AI가 쓸 수 있는 도구가 돼. 이번 3.0 버전에서는 이미지 지원, 에러 처리, 프롬프트 관리 기능이 대폭 강화됐어.
📌 핵심 기능
- 데코레이터 기반:
@mcp.tool,@mcp.resource로 초간단 정의 - 자동 타입 추론: 파이썬 타입 힌트를 보고 자동으로 JSON 스키마 생성
- 이미지 지원: AI에게 이미지를 전송하거나 처리하는 기능 추가
- 스마트한 에러 처리: 코드가 터져도 AI에게 친절한 에러 메시지 전달
- 개발자 친화적: 핫 리로드(Hot Reload) 지원으로 코드 고치면 바로 반영
MAX5의 생각 🎯
👨💻 바이브 코딩 레시피
Claude Code나 커서(Cursor)랑 같이 쓸 때 진짜 강력해. 아래 프롬프트로 나만의 로컬 툴을 만들어봐.
프롬프트 예시:
FastMCP를 사용해서 내 맥북의 '다운로드' 폴더를 정리해주는 MCP 서버를 만들어줘.
1. `list_files(extension)`: 특정 확장자 파일 목록 보여주기
2. `move_file(filename, destination)`: 파일 이동하기
이 두 가지 툴을 구현하고, `mcp dev`로 실행할 수 있게 해줘.
💸 사이드 프로젝트 아이디어
"특정 업무 전용 MCP 에이전트"를 만들어보는 건 어때? 예를 들어 '노션(Notion) 정리 비서'나 '슬랙(Slack) 요약 봇'을 FastMCP로 빠르게 만들어서 배포하는 거지. 복잡한 백엔드 없이 파이썬 스크립트 하나로 AI에게 강력한 기능을 달아줄 수 있어.