공식 Python SDK를 사용하면 MCP 서버를 구축하는 작업이 훨씬 간단해집니다. 도구를 위한 복잡한 JSON 스키마를 직접 작성하는 대신, 데코레이터로 도구를 정의하고 SDK가 번거로운 작업을 처리하도록 할 수 있습니다.

이 예제에서는 문서 작업을 관리하는 MCP 서버를 만들고 있습니다. 이 서버에는 두 가지 주요 도구가 있습니다: 하나는 문서 내용을 읽는 도구이고, 다른 하나는 내용을 업데이트하는 도구입니다. 모든 문서는 키가 문서 ID이고 값이 내용 문자열인 간단한 딕셔너리 형태로 메모리에 존재합니다.
MCP Python SDK의 장점
MCP 프로젝트는 여러 프로그래밍 언어에서 서버와 클라이언트를 구축하기 위한 공식 SDK를 제공합니다. Python SDK를 사용하면 다음과 같은 여러 이점이 있습니다:
- 최소한의 보일러플레이트 코드로 MCP 서버를 생성합니다
- Python 함수 시그니처로부터 JSON 스키마를 자동으로 생성합니다
- 데코레이터를 통해 도구 정의를 단순화합니다
- 타입 검증과 오류 처리를 처리합니다

SDK로 도구를 정의하는 것이 얼마나 쉬운지 보여드리겠습니다. @mcp.tool 데코레이터는 타입 힌트와 필드 설명과 결합되어 Claude가 이해하고 사용할 수 있는 적절한 도구 스키마를 자동으로 생성합니다.
서버 설정하기
기본 서버 설정은 단 몇 줄만 필요합니다:
읽기 도구 구현하기
첫 번째 도구는 Claude가 문서 ID를 제공하여 문서 내용을 읽을 수 있게 합니다:
도구 정의에는 다음이 포함됩니다:
- 작업을 설명하는 명확한 이름
- 도구가 수행하는 작업을 설명하는 설명
- 필드 설명이 있는 타입이 지정된 매개변수
- 잘못된 문서 ID에 대한 오류 처리
편집 도구 구현하기
두 번째 도구는 문서 내용에 대해 간단한 찾기 및 바꾸기 작업을 수행합니다:
이 도구는 세 가지 매개변수를 받습니다: 문서 ID, 찾을 텍스트, 그리고 대체 텍스트입니다. 구현에서는 단순성을 위해 Python의 내장 문자열 replace() 메서드를 사용합니다.
주요 구현 세부사항
MCP SDK로 도구를 정의할 때는 다음과 같은 중요한 사항을 기억하세요:
- 매개변수 설명을 추가하려면 pydantic에서
Field를 임포트하세요 - 매개변수 타입을 지정하려면 타입 힌트를 사용하세요
- 예외 상황에 대한 오류 처리를 포함하세요
- 명확하고 설명적인 도구 이름과 설명을 작성하세요
- SDK는 함수 시그니처를 적절한 JSON 스키마로 자동 변환합니다
MCP Python SDK는 JSON 스키마를 직접 작성하는 것에 비해 도구 생성의 복잡성을 크게 줄여줍니다. 이전에는 수십 줄의 스키마 정의가 필요했던 작업이 이제는 데코레이터가 적용된 몇 줄의 Python 함수만으로 가능합니다.