modelcontextprotocol/quickstart-resources

해결하는 문제

Model Context Protocol (MCP)은 Claude와 같은 AI 어시스턴트가 외부 도구를 호출할 수 있게 하는 표준입니다. 이 저장소는 5개의 프로그래밍 언어로 최소한의 작동하는 서버 및 클라이언트 예제를 제공하여 개발자가 세부 사항을 추측하지 않고 MCP 지원 애플리케이션을 구축하는 방법을 배울 수 있게 합니다.

작동 방식

두 종류의 예제가 있습니다.

• 날씨 서버 (MCP 서버): 미국 국립 기상청 API를 기반으로 하는 get_forecast 및 get_alerts라는 두 도구를 노출하는 간단한 서버. 모든 서버는 stdio를 통해 통신하며 동일한 두 도구를 노출합니다.
• 챗봇 (MCP 클라이언트): 서버를 시작하고, 도구를 나열하고, Claude가 해당 도구를 호출할 수 있는 대화형 채팅 루프를 실행하는 LLM 기반 챗봇. 클라이언트는 ANTHROPIC_API_KEY가 필요하지만, 없어도 연결하고 서버의 도구를 나열할 수 있으므로 자격 증명 없이 MCP 연결을 확인할 수 있습니다.

각 예제는 자체 디렉토리에 있으며 전제 조건, 설정 및 실행 방법을 다루는 README가 포함되어 있습니다. 언어를 혼합하여 사용할 수 있습니다. 예를 들어 Python 클라이언트가 TypeScript 서버를 구동할 수 있습니다. tests 디렉토리에는 CI에서 실행되는 스모크 테스트가 포함되어 모든 서버가 시작되고 MCP 요청에 응답하며 모든 클라이언트가 모의 서버에 연결하고 도구를 나열할 수 있는지 확인합니다.

대상 독자

이것은 Model Context Protocol을 배우는 개발자, 이미 사용하는 언어로 실용적인 예제를 보고 싶은 개발자, 또는 자체 MCP 서버 및 클라이언트를 구축하기 위한 최소한의 잘 테스트된 시작점을 찾는 개발자를 위한 것입니다. 예제는 의도적으로 최소한으로 유지됩니다. 프로토콜을 가르치기 위해 존재하며 프로덕션 서비스가 아닙니다.

주요 특징

• 5개 언어의 예제 서버 및 클라이언트: Python, TypeScript, Go, Rust, Ruby
• 모든 서버가 동일한 두 날씨 도구를 노출하므로 구현을 직접 비교할 수 있습니다
• 클라이언트는 Claude가 서버의 도구를 호출할 수 있는 대화형 챗봇입니다
• 언어 간 상호 운용성 — 클라이언트와 서버를 혼합하여 사용할 수 있습니다
• 모든 풀 리퀘스트에서 자동 스모크 테스트가 실행되어 예제의 신뢰성을 유지합니다
• 설정 및 실행 지침이 포함된 명확한 예제별 README