modelcontextprotocol/python-sdk

어떤 프로젝트인가요?

핵심 기능

• 01타입 힌트가 적용된 Python 함수로 도구, 리소스, 프롬프트를 제공하는 MCP 서버를 구축합니다.
• 02로컬 stdio 서버나 원격 Streamable HTTP 서버에 연결하는 MCP 클라이언트를 구축합니다.
• 03stdio, Streamable HTTP, SSE 전송 방식을 지원합니다.
• 04서버를 실행하고 MCP Inspector를 여는 `mcp` CLI를 제공합니다.

활용 사례

• 내부 API나 데이터베이스를 MCP 도구로 제공해 LLM 어시스턴트에서 사용합니다.
• 기존 MCP 서버의 도구를 호출하는 Python 클라이언트를 작성합니다.
• MCP Inspector로 MCP 서버의 프로토타입을 만들고 디버깅합니다.

빠른 시작

1. 1

   uv를 사용해 CLI extra와 함께 SDK를 설치합니다

   uv add "mcp[cli]"
2. 2

   또는 pip로 설치합니다

   pip install "mcp[cli]"
3. 3

   도구와 리소스가 포함된 server.py를 만듭니다(README 예시 참고)

4. 4

   MCP Inspector에서 서버를 실행합니다

   uv run mcp dev server.py

사용 전 알아둘 점

• !Python 3.11 이상이 필요합니다.
• !README 문서는 v2 API를 다루므로 이전 튜토리얼과 예시가 일치하지 않을 수 있습니다.

토픽

자주 묻는 질문

python-sdk은(는) 무엇인가요?

LLM 애플리케이션을 도구, 데이터, 프롬프트에 연결하는 Model Context Protocol 서버와 클라이언트를 구축하기 위한 공식 Python SDK입니다. MCP Python SDK는 Model Context Protocol의 공식 Python 구현체입니다. Model Context Protocol은 LLM 애플리케이션에 데이터와 기능을 안전하고 표준화된 방식으로 제공하는 개방형 표준입니다. 개발자는 이 SDK로 모든 MCP 호스트에 도구, 리소스, 프롬프트를 제공하는 MCP 서버와 모든 MCP 서버에 연결하는 MCP 클라이언트를 작성할 수 있습니다.

python-sdk은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

python-sdk은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

python-sdk은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. python-sdk의 마지막 커밋은 2026년 10월 17일입니다.

python-sdk은(는) 어디에 사용할 수 있나요?

내부 API나 데이터베이스를 MCP 도구로 제공해 LLM 어시스턴트에서 사용합니다. 기존 MCP 서버의 도구를 호출하는 Python 클라이언트를 작성합니다. MCP Inspector로 MCP 서버의 프로토타입을 만들고 디버깅합니다.

python-sdk는 어떻게 설치하나요?

uv를 사용해 CLI extra와 함께 SDK를 설치합니다: uv add "mcp[cli]" 또는 pip로 설치합니다: pip install "mcp[cli]" 도구와 리소스가 포함된 server.py를 만듭니다(README 예시 참고) MCP Inspector에서 서버를 실행합니다: uv run mcp dev server.py

python-sdk은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/modelcontextprotocol/python-sdk