MCP Python SDK의 개요
Model Context Protocol(MCP)은 AI 앱이 도구와 데이터에 연결하는 표준 방식입니다. 이 저장소는 MCP 서버(도구를 노출)와 클라이언트(도구를 사용)를 작성하는 공식 Python SDK입니다. 공식 TypeScript SDK와 Go, C# SDK도 있습니다.
버전 2.0은 2026-07-28 명세 개정과 함께 2026년 7월 28일에 나왔습니다. FastMCP 클래스는 MCPServer로 이름이 바뀌었고, 단일 Client 객체가 예전의 세션 계층을 대체했으며, WebSocket 전송은 제거됐습니다. 서버는 여전히 이전 클라이언트에 응답합니다.
1.x 계열은 보안 수정만 하는 유지보수 모드입니다.
MCP Python SDK, 쓸 만한 가치가 있습니까?
이것은 Model Context Protocol의 Python 참조 구현이며, 누구보다 먼저 명세를 따라갑니다. 버전 2.0은 2026-07-28 명세 개정과 함께 2026년 7월 28일에 나왔고, 그 개정과 2025-11-25를 동시에 지원합니다. 그래서 v2 서버는 아무 설정 없이도 이전 클라이언트에 응답합니다. 최신 릴리스는 2026년 10월 2일의 v2.3.0입니다.
대가는 마이그레이션입니다. FastMCP는 MCPServer가 됐고, 모듈 경로가 바뀌었고, get_context()가 사라졌고, 전송 설정은 생성자에서 run()으로 옮겨졌으며, 저수준 Server는 데코레이터 대신 생성자 인자 중심으로 다시 만들어졌습니다. 이전 경로는 지원 중단 단계 없이 바로 제거됐습니다. 명세에 포함된 적이 없던 WebSocket 전송도, 실험적 Tasks API도 사라졌습니다. 1.x 계열은 보안 수정과 함께 유지되지만 종료일은 공개되지 않았고, 문서가 안내하는 임시 방편은 mcp>=1.28,<2로 고정하는 것입니다.
보안 작업도 많았습니다. 저장소는 권고 12건을 공개했습니다. 그중에는 Streamable HTTP 세션이 기본적으로 회수되지 않던 높은 심각도의 버그(1.30.0과 2.2.0에서 수정)와, 다른 리소스 서버용으로 발급된 토큰을 받아들이던 bearer 토큰 검사가 있습니다. 2.0이나 2.1에서 HTTP 서버를 운영하는 곳은 업그레이드해야 합니다.
독립 프로젝트인 FastMCP는 현재 PrefectHQ 아래에서 v4.1.3이며, 스타가 약 28,200개로 이 SDK의 24,700개보다 많고 편의 기능을 더 얹었습니다. 부가 기능보다 정확한 명세 동작이 중요한 곳에서는 공식 SDK가 더 군더더기 없는 선택입니다.
제 역할을 하는 곳
Postgres 기반 사내 API를 Claude 등 MCP 클라이언트에 노출하려는 백엔드 개발자
보안팀이 승인할 MCP 서버 내놓기
도구를 MCPServer의 데코레이터 함수로 작성하고, 인증 뒤에서 Streamable HTTP로 실행하며, 세션 회수와 토큰 대상 수정을 위해 2.2.0 이상을 씁니다. 첫 서버는 수십 줄이면 됩니다.
v1 MCP 서버 열 개를 관리하는 플랫폼팀
클라이언트를 깨뜨리지 않고 v2 이전 계획 세우기
보안 수정을 받도록 mcp>=1.28,<2로 고정한 뒤, 마이그레이션 가이드의 변경 전후 목록을 보며 서버를 하나씩 옮깁니 다. v2는 두 명세 개정을 모두 지원하므로 클라이언트를 동시에 바꿀 필요가 없습니다.
새 제품의 Python MCP 스택을 고르는 엔지니어링 매니저
공식 SDK와 FastMCP 사이에서 결정하기
공식 SDK는 MIT이고 MCP 프로젝트가 관리하며 명세를 가장 먼저 따라갑니다. FastMCP는 그 위에 더 많은 기능을 얹습니다. 둘 다 무료이므로 선택은 명세 충실도와 편의성 및 업그레이드 부담 사이의 문제입니다.
도입 전 확인할 점
- 설정
- Python 3.10+에서 uv add "mcp[cli]" 또는 pip install "mcp[cli]"를 실행하고, uv run mcp run server.py --transport streamable-http로 서버를 시작합니다. 데코레이터 도구 하나와 첫 호출까지 몇 분이면 됩니다.
- 연동
- Claude 앱과 에이전트 프레임워크를 포함한 모든 MCP 클라이언트와 동작합니다. stdio나 Streamable HTTP로 서버를 호출하는 Client를 제공하며, TypeScript, Go, C#용 자매 SDK가 있습니다. 와이어 타입은 별도의 mcp-types 패키지에 있습니다.
- 데이터와 개인정보
- 라이브러리이므로 스스로는 아무것도 보내지 않습니다. 서버는 도구가 접근할 수 있는 모든 것을 보게 되므로 인증과 범위 제한은 사용자의 몫입니다. Streamable HTTP의 세션 유출과 스키마 검증 중 서버가 지정한 $ref URL을 가져오던 클라이언트를 포함해 권고 12건이 공개됐습니다.
- 대규모 사용 시 비용
- MIT로 무료입니다. 서버 호스팅은 일반적인 Python 웹 호스팅이며, 2026년 방식의 요청에는 세션이 없어 고정 세션 라우팅 문제가 사라집니다.
- 제한
- 열린 이슈 약 370개. 2026년 방식의 연결에서는 서버가 시작하는 요청이 없어져 ctx.elicit()가 실패하고 Resolve(...)가 이를 대체합니다. roots, sampling, 프로토콜 로깅은 지원 중단됐고 ping은 제거됐습니다.
좋은 점
- 새 명세 개정을 가장 먼저 구현
- v2 서버가 2026-07-28과 2025-11-25 클라이언트 모 두에 응답
- MCPServer에서 도구, 리소스, 프롬프트용 데코레이터 제공
- stdio, Streamable HTTP, SSE 전송
아쉬운 점
- v2가 v1 import 경로를 바로 제거
- WebSocket 전송과 Tasks API 삭제
- 보안 권고 12건, 2.0과 2.1은 업그레이드 필요
- 독립 FastMCP보다 부가 기능이 적음
추천 대상
명세를 따라가는 공식 구현을 원하며 MCP 서버나 클라이언트를 만드는 Python 개발자.
MCP Python SDK 대안
MCP Python SDK: 자주 묻는 질문
- MCP Python SDK, 쓸 만한 가치가 있습니까?
- Python으로 MCP를 만드는 명세 우선의 방법입니다. 버전 2는 더 깔끔해졌지만, 그 과정에서 v1의 import를 전부 깨뜨립니다. 평점은 5점 만점에 4.4점입니다.
- MCP Python SDK의 가격은 얼마입니까?
- MIT 라이선스의 무료 오픈소스입니다.
- MCP Python SDK의 단점은 무엇입니까?
- v2가 v1 import 경로를 바로 제거; WebSocket 전송과 Tasks API 삭제; 보안 권고 12건, 2.0과 2.1은 업그레이드 필요; 독립 FastMCP보다 부가 기능이 적음.
- MCP Python SDK에 적합한 사람은 누구입니까?
- 명세를 따라가는 공식 구현을 원하며 MCP 서버나 클라이언트를 만드는 Python 개발자.
- 팀이나 프로덕션 환경에서 MCP Python SDK의 비용은 얼마입니까?
- MIT로 무료입니다. 서버 호스팅은 일반적인 Python 웹 호스팅이며, 2026년 방식의 요청에는 세션이 없어 고정 세션 라우팅 문제가 사라집니다.
- MCP Python SDK에 회사 데이터를 맡겨도 안전합니까?
- 라이브러리이므로 스스로는 아무것도 보내지 않습니다. 서버는 도구가 접근할 수 있는 모든 것을 보게 되므로 인증과 범위 제한은 사용자의 몫입니다. Streamable HTTP의 세션 유출과 스키마 검증 중 서버가 지정한 $ref URL을 가져오던 클라이언트를 포함해 권고 12건이 공개됐습니다.
- MCP Python SDK의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 OpenAI Agents SDK 및 Pydantic AI입니다.
답변 확인일: 2026년 10월 23일.
MCP Python SDK 개발사입니까? 이 평점을 사이트에 표시하십시오
