modelcontextprotocol/swift-sdk

해결하는 문제

Model Context Protocol (MCP) 은 애플리케이션이 AI 모델과 통신하는 방식을 표준화합니다. 이 SDK는 Swift 개발자가 클라이언트(MCP 서버에 연결하는 앱)와 서버(클라이언트에 기능을 노출하는 앱)를 모두 구축할 수 있는 공식 빌딩 블록을 제공합니다. 이 SDK가 없다면 개발자는 프로토콜을 처음부터 직접 구현해야 합니다.

작동 방식

이 SDK에는 stdio 또는 HTTP 전송을 통해 MCP 서버에 연결하기 위한 Client 클래스와 기능을 호스팅하기 위한 Server 클래스가 포함되어 있습니다. 두 클래스 모두 도구, 리소스, 프롬프트, 완성, 샘플링(서버에서 클라이언트로의 LLM 요청), 유도(서버에서 클라이언트로의 사용자 입력 요청), 루트(파일 시스템 경계), 로깅, 진행 상황 업데이트와 같은 핵심 MCP 기능을 지원합니다. 클라이언트는 엄격하거나 엄격하지 않은 기능 검사, 요청 일괄 처리 및 취소를 지원합니다. 서버에는 정상적인 종료 및 HTTP 요청 컨텍스트 처리가 포함되어 있습니다.

대상 사용자

MCP를 통해 AI/ML 모델과 상호 작용해야 하는 애플리케이션을 구축하거나, 도구, 데이터 및 프롬프트를 노출하기 위한 MCP 서버를 만드는 Swift 개발자. Swift 6.0+ (Xcode 16+) 가 필요합니다.

주요 특징

• 최신 MCP 사양 (2025-11-25) 에 맞춘 공식 SDK.
• 클라이언트와 서버 구현을 하나의 패키지에 모두 포함.
• 다중 전송 지원: 로컬 하위 프로세스를 위한 stdio 및 원격 통신을 위한 스트리밍 HTTP.
• 포괄적인 클라이언트 기능: 도구, 리소스, 프롬프트, 완성, 샘플링, 유도, 루트, 로깅, 취소, 진행 상황 추적, 일괄 처리 및 인증 흐름.
• 서버 기능: 동일한 기능과 더불어 초기화 훅, HTTP 요청 컨텍스트, 정상적인 종료 지원.
• Swift Package Manager 를 통한 간편한 통합.