** 건축용 종합 튜토리얼 Context Protocol (MCP) Enabled AI Agents**

---

# # . # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

이 저장소는 Model Context Protocol (MCP)를 사용하여 정교한 분산 시스템을 만들기 위해 간단한 AI 에이전트를 구축하기 위해 ** 완전한, 손에 여행 **를 제공합니다. 6개의 주의깊게 만들어진 여정을 통해 MCP 건축의 기본적인 개념과 진보된 본을 마스터할 것입니다.

당신이 배울거야

• Agent Architecture Evolution: 모노리딕에서 모듈형, 프로토콜 구동 설계
• MCP Protocol Mastery: stdio 및 SSE 수송, 공구 발견, 세션 관리 -Production Patterns: 오류 처리, 구조화된 데이터, 멀티포트 구성
• Real-world 통합: 외부 API, 원격 서비스, 분산 도구 생태계

---

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

칫 단계 1 Naive 대리인 hardcoded 도구를 가진 간단한 대리인

· 단계 2 향상된 에이전트 Async 패턴 및 코드 정리

· 3 단계 MCP 재단 stdio 서버 및 사용자 정의 MCP 클라이언트

₢ 킹 단계 4 공식 도서관 Anthropic의 MCP Python SDK 사용

· 5 단계 원격 서비스 API 통합과 SSE 운송

·

Step by Step to MCP Glory

A Comprehensive Tutorial for Building Model Context Protocol (MCP) Enabled AI Agents

---

🌟 Overview

This repository provides a complete, hands-on journey from building a simple AI agent to creating sophisticated, distributed systems using the Model Context Protocol (MCP). Through 6 carefully crafted iterations, you’ll master the fundamental concepts and advanced patterns of MCP architecture.

🎯 What You’ll Learn

• Agent Architecture Evolution: From monolithic to modular, protocol-driven design
• MCP Protocol Mastery: stdio and SSE transports, tool discovery, session management
• Production Patterns: Error handling, structured data, multi-transport composition
• Real-world Integration: External APIs, remote services, distributed tool ecosystems

---

🗺️ The Journey

---

🚀 Quick Start

Prerequisites

• Python 3.8+
• API Keys: Tavily (web search), OpenWeatherMap (weather)
• OpenAI API access

1-Minute Setup

# Clone and setup
git clone 
cd MCP-Transition
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your API keys

# Run any stage
python naive_agent.py           # Stage 1
python improved_agent.py        # Stage 2
python mcp_agent_sse.py         # Stage 5 (requires weather server)
python mcp_agent_streamable.py  # Stage 7 (requires streamable server)

Environment Variables

# .env file
OPENAI_API_KEY=your_openai_key_here
TAVILY_API_KEY=your_tavily_key_here
OPENWEATHERMAP_API_KEY=your_weather_key_here

---

📖 Detailed Documentation