Skip to content

Latest commit

 

History

History
542 lines (447 loc) · 33 KB

File metadata and controls

542 lines (447 loc) · 33 KB

변경 로그: 초보자를 위한 MCP 커리큘럼

이 문서는 Model Context Protocol (MCP) 초보자용 커리큘럼에 이루어진 모든 주요 변경 사항을 기록한 문서입니다. 변경 사항은 역순(최신 변경 사항 우선)으로 기록되어 있습니다.

2026년 2월 5일

리포지토리 전체 검증 및 내비게이션 개선

새로운 커리큘럼 콘텐츠 추가

모듈 03 - 시작하기

  • 12-mcp-hosts/README.md: MCP 호스트 설정에 대한 포괄적인 새 가이드

    • Claude Desktop, VS Code, Cursor, Cline, Windsurf 구성 예시
    • 주요 모든 호스트에 대한 JSON 구성 템플릿
    • 전송 유형 비교 표(stdio, SSE/HTTP, WebSocket)
    • 일반적인 연결 문제 해결
    • 호스트 구성 보안 모범 사례
  • 13-mcp-inspector/README.md: MCP Inspector용 새 디버깅 가이드

    • 설치 방법(npx, npm 글로벌, 소스에서)
    • stdio 및 HTTP/SSE를 통한 서버 연결
    • 테스트 도구, 리소스 및 프롬프트 워크플로우
    • VS Code와 MCP Inspector 통합
    • 일반적인 디버깅 시나리오 및 해결책

모듈 04 - 실전 구현

  • pagination/README.md: 새 페이지네이션 구현 가이드
    • Python, TypeScript, Java에서의 커서 기반 페이지네이션 패턴
    • 클라이언트 측 페이지네이션 처리
    • 커서 설계 전략(불투명 vs. 구조화)
    • 성능 최적화 권장 사항

모듈 05 - 고급 주제

  • mcp-protocol-features/README.md: 새 프로토콜 기능 심층 탐구
    • 진행 상태 알림 구현
    • 요청 취소 패턴
    • URI 패턴이 포함된 리소스 템플릿
    • 서버 수명 주기 관리
    • 로깅 레벨 제어
    • JSON-RPC 코드와 함께하는 오류 처리 패턴

내비게이션 수정 (24개 이상의 파일 업데이트)

주요 모듈 README들
첫 번째 강의와 다음 모듈 모두에 대한 링크 추가

02-Security 하위 파일들
5개의 보안 보충 문서 모두에 "다음은?" 내비게이션 추가

09-CaseStudy 파일들
모든 사례 연구 파일에 순차적 내비게이션 추가

10-StreamliningAI Labs
모듈 10 개요와 모듈 11에 "다음은?" 섹션 추가

코드 및 콘텐츠 수정

SDK 및 종속성 업데이트
빈 openai 버전을 ^4.95.0으로 수정
SDK를 ^1.8.0에서 >=1.26.0으로 업데이트
mcp 버전 핀을 >=1.26.0으로 업데이트

코드 수정
잘못된 모델 gpt-4o-minigpt-4.1-mini로 수정

콘텐츠 수정
깨진 링크 READMEmdREADME.md 수정, 커리큘럼 헤더 Module 1-3Module 0-3으로 수정, 대소문자 구분 경로 수정
손상된 중복 Case Study 5 내용 제거

초보자 안내 개선
초보자를 위한 적절한 소개, 학습 목표 및 선수 지식 추가

커리큘럼 업데이트

메인 README.md
커리큘럼 표에 3.12 (MCP Hosts), 3.13 (MCP Inspector), 4.1 (페이지네이션), 5.16 (프로토콜 기능) 항목 추가

모듈 README들
강의 12, 13 추가
실용 가이드 섹션에 페이지네이션 링크 추가
강의 5.15 (사용자 지정 전송), 5.16 (프로토콜 기능) 추가

study_guide.md
마인드맵에 새로운 주제들 추가: MCP Hosts 설정, MCP Inspector, 페이지네이션 전략, 프로토콜 기능 심층 탐구

2026년 1월 28일

MCP 명세 2025-11-25 준수 검토

핵심 개념 강화 (01-CoreConcepts/)

  • 새 클라이언트 원시 요소 - Roots: 서버가 파일 시스템 경계 및 접근 권한을 이해할 수 있도록 Roots 클라이언트 원시 요소에 대한 포괄적 문서 추가
  • 도구 주석: 더 나은 도구 실행 결정을 위한 도구 동작 주석(readOnlyHint, destructiveHint) 문서 추가
  • 샘플링 시 도구 호출: 샘플링 요청 중 모델 기반 도구 호출을 위한 toolstoolChoice 매개변수 문서 업데이트
  • URL 모드 유발: 서버 시작 외부 웹 상호작용을 위한 URL 기반 유발 문서 추가
  • 작업(실험적): 내구성 실행 래퍼와 지연된 결과 검색을 위한 실험적 기능인 작업 기능 새 섹션 문서 추가
  • 아이콘 지원: 도구, 리소스, 리소스 템플릿, 프롬프트에 아이콘을 추가 메타데이터로 포함 가능하다는 내용 언급

문서 업데이트

  • README.md: MCP 명세 2025-11-25 버전 참조 및 날짜 기반 버전 관리 설명 추가
  • study_guide.md: 핵심 개념 섹션에 작업과 도구 주석 포함하도록 커리큘럼 맵 업데이트; 문서 타임스탬프 갱신

명세 준수 검증

  • 프로토콜 버전: 모든 문서가 최신 MCP 명세 2025-11-25 참조 여부 확인
  • 아키텍처 정렬: 2계층 아키텍처(데이터 계층 + 전송 계층) 문서 정확성 확인
  • 원시 요소 문서: 서버 원시 요소(리소스, 프롬프트, 도구) 및 클라이언트 원시 요소(샘플링, 유발, 로깅, 루츠) 검증
  • 전송 메커니즘: STDIO 및 스트리밍 HTTP 전송 문서 정확성 확인
  • 보안 지침: 최신 MCP 보안 모범 사례 문서와 일치 확인

MCP 2025-11-25 주요 기능 문서화

  • OpenID Connect 디스커버리: OIDC를 통한 인증 서버 디스커버리
  • OAuth 클라이언트 ID 메타데이터 문서: 권장 클라이언트 등록 메커니즘
  • JSON 스키마 2020-12: MCP 스키마 정의 기본 방언
  • SDK 계층화 시스템: SDK 기능 지원 및 유지보수 요구 사항 공식화
  • 거버넌스 구조: MCP 거버넌스 내 작업 그룹 및 관심 그룹 공식화

보안 문서 대규모 업데이트 (02-Security/)

MCP Security Summit Workshop (Sherpa) 통합

  • 새 실습 교육 자료: 모든 보안 문서에 MCP Security Summit Workshop (Sherpa)의 포괄적 통합 추가
  • 원정 경로 안내: 베이스캠프부터 정상까지 완전한 캠프 간 진행 과정 문서화
  • OWASP 정렬: 모든 보안 지침을 OWASP MCP Azure Security Guide 위험에 매핑

OWASP MCP Top 10 통합

  • 새 섹션: 메인 보안 README에 OWASP MCP Top 10 보안 위험 테이블 및 Azure 완화책 추가
  • 위험 기반 문서화: mcp-security-controls-2025.md 업데이트하여 각 보안 도메인에 대한 OWASP MCP 위험 참조
  • 참조 아키텍처: OWASP MCP Azure Security Guide 참조 아키텍처 및 구현 패턴 링크 추가

보안 파일 업데이트

  • README.md: Sherpa 워크숍 개요, 원정 경로 표, OWASP MCP Top 10 요약 및 실습 교육 섹션 추가
  • mcp-security-controls-2025.md: 헤더를 2026년 2월로 업데이트, OWASP 위험 참조(MCP01-MCP08) 추가, 명세 버전 불일치 수정
  • mcp-security-best-practices-2025.md: Sherpa 및 OWASP 리소스 섹션 추가, 타임스탬프 갱신
  • mcp-best-practices.md: Sherpa 및 OWASP 링크가 포함된 실습 교육 섹션 추가
  • azure-content-safety-implementation.md: OWASP MCP06 참조, Sherpa 캠프 3 정렬, 추가 리소스 섹션 추가

새 리소스 링크 추가

커리큘럼 전체 MCP 명세 2025-11-25 정렬

모듈 03 - 시작하기

  • SDK 문서: Go SDK를 공식 SDK 목록에 추가; 모든 SDK 참조를 MCP 명세 2025-11-25에 맞게 업데이트
  • 전송 명확화: STDIO 및 HTTP 스트리밍 전송 설명에 명세 명확한 참조 추가

모듈 04 - 실전 구현

  • SDK 업데이트: Go SDK 추가; 명세 버전 참조와 SDK 목록 업데이트
  • 권한 명세: MCP 권한 명세 링크를 최신 2025-11-25 버전으로 업데이트

모듈 05 - 고급 주제

  • 새 기능: MCP 명세 2025-11-25의 새 기능(작업, 도구 주석, URL 모드 유발, 루츠) 관련 참고사항 추가
  • 보안 리소스: OWASP MCP Top 10 및 Sherpa 워크숍 링크 추가

모듈 06 - 커뮤니티 기여

  • SDK 목록: Swift 및 Rust SDK 추가; 명세 링크를 2025-11-25로 업데이트
  • 명세 참조: MCP 명세 링크를 명세 URL로 업데이트

모듈 07 - 초기 도입 사례

  • 리소스 업데이트: 추가 리소스에 MCP 명세 2025-11-25 링크 및 OWASP MCP Top 10 추가

모듈 08 - 모범 사례

  • 명세 버전: MCP 명세 참조를 2025-11-25로 업데이트
  • 보안 리소스: 추가 참고문헌에 OWASP MCP Top 10 및 Sherpa 워크숍 추가

모듈 10 - AI 워크플로우 간소화

  • 배지 업데이트: MCP 버전 배지를 SDK 버전(1.9.3)에서 명세 버전(2025-11-25)으로 변경
  • 리소스 링크: MCP 명세 링크 업데이트; OWASP MCP Top 10 추가

모듈 11 - MCP 서버 실습 실험실

  • 명세 참조: MCP 명세 링크를 2025-11-25 버전으로 업데이트
  • 보안 리소스: 공식 리소스에 OWASP MCP Top 10 추가

2025년 12월 18일

보안 문서 업데이트 - MCP 명세 2025-11-25

MCP 보안 모범 사례 (02-Security/mcp-best-practices.md) - 명세 버전 업데이트

  • 프로토콜 버전 업데이트: 최신 MCP 명세 2025-11-25(2025년 11월 25일 발행) 참조로 업데이트
    • 모든 명세 버전 참조를 2025-06-18에서 2025-11-25로 변경
    • 문서 날짜 참조를 2025년 8월 18일에서 2025년 12월 18일로 변경
    • 모든 명세 URL이 최신 문서로 연결되는지 확인
  • 내용 검증: 최신 표준에 따른 보안 모범 사례 전면 검증
    • Microsoft 보안 솔루션: Prompt Shields(이전 "Jailbreak 위험 탐지"), Azure Content Safety, Microsoft Entra ID, Azure Key Vault 용어 및 링크 최신화
    • OAuth 2.1 보안: 최신 OAuth 보안 모범 사례와 일치 확인
    • OWASP 표준: LLM용 OWASP Top 10 참조가 최신 상태임 확인
    • Azure 서비스: 모든 Microsoft Azure 문서 링크 및 모범 사례 검증
  • 표준 정렬: 모든 참조된 보안 표준 최신 상태 확인
    • NIST AI 위험 관리 프레임워크
    • ISO 27001:2022
    • OAuth 2.1 보안 모범 사례
    • Azure 보안 및 규정 준수 프레임워크
  • 구현 리소스: 모든 구현 가이드 링크 및 리소스 검증
    • Azure API Management 인증 패턴
    • Microsoft Entra ID 통합 가이드
    • Azure Key Vault 비밀 관리
    • DevSecOps 파이프라인 및 모니터링 솔루션

문서 품질 보증

  • 명세 준수: 최신 명세에 따른 모든 필수 MCP 보안 요구 사항(MUST/MUST NOT) 준수 검증
  • 리소스 최신성: Microsoft 문서, 보안 표준, 구현 가이드에 대한 외부 링크 최신성 확인
  • 모범 사례 범위: 인증, 권한 부여, AI 특정 위협, 공급망 보안, 기업 패턴에 대한 포괄적 적용 확인

2025년 10월 6일

시작하기 섹션 확장 – 고급 서버 사용법 및 간단 인증

고급 서버 사용법 (03-GettingStarted/10-advanced)

  • 새 장 추가: 일반 및 저수준 서버 아키텍처 모두를 다루는 고급 MCP 서버 사용법에 대한 포괄적 가이드 추가
    • 일반 vs 저수준 서버: 두 접근법에 대한 상세 비교 및 Python, TypeScript 코드 예시 제공
    • 핸들러 기반 설계: 확장 가능하고 유연한 서버 구현을 위한 도구/리소스/프롬프트 관리 방식 설명
    • 실전 패턴: 저수준 서버 패턴이 고급 기능 및 아키텍처에 유용한 실제 사례

간단 인증 (03-GettingStarted/11-simple-auth)

  • 새 장 추가: MCP 서버에서 간단 인증 구현에 대한 단계별 가이드 제공
    • 인증 개념: 인증과 권한 부여, 자격 증명 처리에 대한 명확한 설명
    • 기본 인증 구현: Python (Starlette) 및 TypeScript (Express)에서 미들웨어 기반 인증 패턴과 코드 샘플
    • 고급 보안으로의 발전: 간단 인증에서 시작해 OAuth 2.1과 RBAC로 확장하는 지침과 고급 보안 모듈 참조

이 추가 사항들은 견고하고 안전하며 유연한 MCP 서버 구현을 위한 실습 위주 지침을 제공하며, 기초 개념과 고급 생산 패턴을 연결합니다.

2025년 9월 29일

MCP 서버 데이터베이스 통합 실습 - 포괄적 실습 학습 경로

11-MCPServerHandsOnLabs - 새로운 완전한 데이터베이스 통합 커리큘럼 추가

  • 완성된 13개 랩 학습 경로: PostgreSQL 데이터베이스 통합과 함께 프로덕션 준비 완료 MCP 서버 구축을 위한 포괄적인 실습 커리큘럼 추가
    • 실제 적용 사례: 엔터프라이즈급 패턴을 보여주는 Zava 리테일 분석 사례
    • 구조화된 학습 진행:
      • 랩 00-03: 기초 - 소개, 핵심 아키텍처, 보안 및 멀티테넌시, 환경 설정
      • 랩 04-06: MCP 서버 구축 - 데이터베이스 설계 및 스키마, MCP 서버 구현, 도구 개발
      • 랩 07-09: 고급 기능 - 의미 기반 검색 통합, 테스트 및 디버깅, VS Code 통합
      • 랩 10-12: 프로덕션 및 모범 사례 - 배포 전략, 모니터링 및 관측, 모범 사례 및 최적화
    • 엔터프라이즈 기술: FastMCP 프레임워크, pgvector 지원 PostgreSQL, Azure OpenAI 임베딩, Azure Container Apps, Application Insights
    • 고급 기능: 행 수준 보안(RLS), 의미 기반 검색, 멀티테넌트 데이터 접근, 벡터 임베딩, 실시간 모니터링

용어 표준화 - 모듈에서 랩으로 변경

  • 포괄적 문서 업데이트: 11-MCPServerHandsOnLabs 내 모든 README 파일을 체계적으로 “Module”에서 “Lab” 용어로 변경
    • 섹션 헤더: 13개 랩 전체의 “What This Module Covers”를 “What This Lab Covers”로 변경
    • 내용 설명: 문서 전반에 걸쳐 “This module provides...”를 “This lab provides...”로 변경
    • 학습 목표: “By the end of this module...”을 “By the end of this lab...”로 업데이트
    • 네비게이션 링크: 교차 참조와 네비게이션에서 모든 “Module XX:”를 “Lab XX:”로 변환
    • 완료 추적: “After completing this module...”을 “After completing this lab...”로 변경
    • 기술 참조 유지: 설정 파일 내 Python 모듈 참조는 그대로 유지 (예: "module": "mcp_server.main")

학습 가이드 개선 (study_guide.md)

  • 커리큘럼 시각화 지도: “11. Database Integration Labs” 섹션 추가 및 상세한 랩 구조 시각화 포함
  • 저장소 구조: 열 개에서 열한 개 섹션으로 업데이트하며 11-MCPServerHandsOnLabs 세부 설명 추가
  • 학습 경로 안내: 00-11 섹션을 모두 포함하도록 네비게이션 지침 강화
  • 기술 범위: FastMCP, PostgreSQL, Azure 서비스 통합 세부사항 추가
  • 학습 결과: 프로덕션 준비 완료 서버 개발, 데이터베이스 통합 패턴, 엔터프라이즈 보안 강조

메인 README 구조 개선

  • 랩 기반 용어 사용: 11-MCPServerHandsOnLabs 메인 README.md에서 일관되게 “Lab” 구조 사용으로 업데이트
  • 학습 경로 조직: 기초 개념부터 고급 구현, 프로덕션 배포까지 명확한 진행 단계 제시
  • 실제 적용 중심: 엔터프라이즈급 패턴과 기술을 활용한 실무 중심 학습 강조

문서 품질 및 일관성 개선

  • 실습 중심 학습 강조: 문서 전반에 실습 랩 기반 접근법 강화
  • 엔터프라이즈 패턴 중점: 프로덕션 준비 완료 구현 및 엔터프라이즈 보안 사항 강조
  • 기술 통합: 최신 Azure 서비스 및 AI 통합 패턴 포괄적으로 다룸
  • 학습 진행: 기본 개념부터 프로덕션 배포까지 명확하고 체계적 경로 제시

2025년 9월 26일

사례 연구 강화 - GitHub MCP Registry 통합

사례 연구 (09-CaseStudy/) - 생태계 개발 중점

  • README.md: GitHub MCP Registry 사례 연구 확장
    • GitHub MCP Registry 사례 연구: 2025년 9월 GitHub MCP Registry 출시 전면 분석
      • 문제 분석: 분산된 MCP 서버 탐색 및 배포 문제 상세 검토
      • 솔루션 아키텍처: 중앙 집중형 레지스트리 방식 및 원클릭 VS Code 설치
      • 비즈니스 영향: 개발자 온보딩 및 생산성 향상 측정
      • 전략적 가치: 모듈화된 에이전트 배포 및 도구 간 상호운용성 집중
      • 생태계 개발: 에이전트 통합을 위한 기초 플랫폼으로 포지셔닝
    • 사례 연구 구조 개선: 7개 사례 모두 일관된 포맷과 상세 설명으로 업데이트
      • Azure AI 여행 에이전트: 다중 에이전트 오케스트레이션 강조
      • Azure DevOps 통합: 워크플로우 자동화 중점
      • 실시간 문서 검색: Python 콘솔 클라이언트 구현
      • 대화형 학습 계획 생성기: Chainlit 대화형 웹 앱
      • 편집기 내 문서: VS Code 및 GitHub Copilot 통합
      • Azure API 관리: 엔터프라이즈 API 통합 패턴
      • GitHub MCP Registry: 생태계 개발 및 커뮤니티 플랫폼
    • 종합 결론: 7개 사례 연구가 다루는 MCP 구현 다차원적 분류 및 총괄
      • 엔터프라이즈 통합, 다중 에이전트 오케스트레이션, 개발자 생산성
      • 생태계 개발, 교육용 애플리케이션 분류
      • 아키텍처 패턴, 구현 전략 및 모범 사례 깊이 있는 통찰
      • MCP를 성숙하고 프로덕션 준비된 프로토콜로 강조

학습 가이드 업데이트 (study_guide.md)

  • 커리큘럼 맵: 사례 연구 섹션에 GitHub MCP Registry 추가로 마인드맵 업데이트
  • 사례 연구 설명: 일반 설명에서 7개 상세 사례 연구로 내용 강화
  • 저장소 구조: 10번 섹션에서 구체적 구현 내역 포함한 포괄적 사례 연구로 갱신
  • 변경 로그 통합: 2025년 9월 26일 항목 추가, GitHub MCP Registry 및 사례 연구 강화 내용 포함
  • 날짜 갱신: 최신 개정판 날짜로 푸터 타임스탬프 업데이트

문서 품질 향상

  • 일관성 강화: 7개 사례 모두 동일한 포맷과 구조 적용
  • 포괄적 범위: 엔터프라이즈, 개발자 생산성, 생태계 개발 시나리오 아우름
  • 전략적 포지션: MCP를 에이전틱 시스템 배포를 위한 기초 플랫폼으로 강조
  • 자원 통합: 추가 자료에 GitHub MCP Registry 링크 포함

2025년 9월 15일

고급 주제 확장 - 사용자 정의 전송 및 컨텍스트 엔지니어링

MCP 사용자 정의 전송 (05-AdvancedTopics/mcp-transport/) - 신규 고급 구현 가이드

  • README.md: 맞춤형 MCP 전송 메커니즘 완전 구현 가이드
    • Azure Event Grid 전송: 서버리스 이벤트 기반 전송 구현
      • C#, TypeScript, Python 예제 및 Azure Functions 통합
      • 확장 가능한 MCP용 이벤트 기반 아키텍처 패턴
      • 웹훅 수신기 및 푸시형 메시지 처리
    • Azure Event Hubs 전송: 고처리량 스트리밍 전송 구현
      • 저지연 실시간 스트리밍 지원
      • 파티션 전략 및 체크포인트 관리
      • 메시지 배치 및 성능 최적화
    • 엔터프라이즈 통합 패턴: 프로덕션 준비 아키텍처 예시
      • 여러 Azure Functions 간 분산 MCP 처리
      • 하이브리드 전송 아키텍처 결합
      • 메시지 내구성, 신뢰성, 오류 처리 전략
    • 보안 및 모니터링: Azure Key Vault 통합 및 관측 패턴
      • 관리 형 아이덴티티 인증 및 최소 권한 접근
      • Application Insights 텔레메트리 및 성능 모니터링
      • 회로 차단기 및 내결함성 패턴
    • 테스트 프레임워크: 맞춤 전송용 종합 테스트 전략
      • 테스트 더블 및 모킹 기반 단위 테스트
      • Azure Test Containers 활용 통합 테스트
      • 성능 및 부하 테스트 고려사항

컨텍스트 엔지니어링 (05-AdvancedTopics/mcp-contextengineering/) - 신흥 AI 분야

  • README.md: 컨텍스트 엔지니어링 신흥 분야 심층 탐구
    • 핵심 원칙: 완전한 컨텍스트 공유, 행동 판단 인지, 컨텍스트 창 관리
    • MCP 프로토콜 정렬: MCP 설계가 컨텍스트 엔지니어링 문제 해결하는 방식
      • 컨텍스트 창 제한 및 점진적 로딩 전략
      • 연관성 판단 및 동적 컨텍스트 검색
      • 다중 모드 컨텍스트 처리 및 보안 고려사항
    • 구현 접근: 단일 스레드 대 다중 에이전트 아키텍처
      • 컨텍스트 청킹 및 우선순위 기법
      • 점진적 컨텍스트 로딩 및 압축 전략
      • 레이어드 컨텍스트 방식 및 검색 최적화
    • 측정 프레임워크: 컨텍스트 효과성 평가 신흥 지표
      • 입력 효율성, 성능, 품질 및 사용자 경험 고려사항
      • 컨텍스트 최적화를 위한 실험적 접근
      • 실패 분석 및 개선 방법론

커리큘럼 네비게이션 업데이트 (README.md)

  • 모듈 구조 확장: 신규 고급 주제 추가 및 커리큘럼 테이블 업데이트
    • 컨텍스트 엔지니어링 (5.14), 사용자 정의 전송 (5.15) 항목 추가
    • 모든 모듈에 대한 일관된 서식 및 네비게이션 링크 적용
    • 현재 내용 범위 반영한 설명 업데이트

디렉터리 구조 개선

  • 명명 표준화: “mcp transport” 폴더를 “mcp-transport”로 이름 변경하여 다른 고급 주제 폴더와 일치시킴
  • 내용 조직: 모든 05-AdvancedTopics 폴더가 일관된 명명 규칙(mcp-[topic]) 따름

문서 품질 향상

  • MCP 사양 정렬: 모든 신규 콘텐츠가 MCP Specification 2025-06-18 참조
  • 다중 언어 예제: C#, TypeScript, Python 종합 코드 예제 수록
  • 엔터프라이즈 집중: 프로덕션 준비 패턴 및 Azure 클라우드 통합 전반에 강조
  • 시각 자료 제공: 아키텍처 및 흐름 시각화를 위한 Mermaid 다이어그램 포함

2025년 8월 18일

문서 대규모 업데이트 - MCP 2025-06-18 표준 반영

MCP 보안 모범 사례 (02-Security/) - 완전 현대화

  • MCP-SECURITY-BEST-PRACTICES-2025.md: MCP Specification 2025-06-18에 맞춰 완전 재작성
    • 필수 요구 사항: 공식 사양에서 MUST/MUST NOT 요구 명확 시각 표시 포함 추가
    • 12가지 핵심 보안 관행: 기존 15항목 목록에서 보안 도메인별 재구성
      • 토큰 보안 및 인증, 외부 아이덴티티 제공자 통합
      • 세션 관리 및 전송 보안, 암호화 요구 사항
      • AI 특화 위협 방어, Microsoft Prompt Shields 통합
      • 접근 제어 및 권한, 최소 권한 원칙 적용
      • 콘텐츠 안전 및 모니터링, Azure Content Safety 통합
      • 공급망 보안, 포괄적 컴포넌트 검증
      • OAuth 보안 및 Confused Deputy 방지, PKCE 구현
      • 사고 대응 및 복구, 자동화 기능 포함
      • 컴플라이언스 및 거버넌스, 규제 준수 정렬
      • 고급 보안 제어, 제로 트러스트 아키텍처
      • Microsoft 보안 생태계 통합, 포괄 솔루션
      • 지속적 보안 진화, 적응형 관행
    • Microsoft 보안 솔루션: Prompt Shields, Azure Content Safety, Entra ID, GitHub Advanced Security 통합 가이드 강화
    • 구현 자료: 공식 MCP 문서, Microsoft 보안 솔루션, 보안 기준, 구현 가이드별 분류된 종합 리소스 링크

고급 보안 제어 (02-Security/) - 엔터프라이즈 구현

  • MCP-SECURITY-CONTROLS-2025.md: 엔터프라이즈급 보안 프레임워크로 완전 개편
    • 9개 보안 도메인 확대: 기본 제어에서 상세 엔터프라이즈 프레임워크로 확장
      • Microsoft Entra ID 통합 고급 인증 및 권한 부여
      • 포괄적 검증을 위한 토큰 보안 및 안티 패스스루 제어
      • 탈취 방지 세션 보안 제어
      • 프롬프트 인젝션 및 도구 오염 방지 AI 특화 보안 제어
      • OAuth 프록시 보안으로 Confused Deputy 공격 방지
      • 샌드박스 및 격리 기반 도구 실행 보안
      • 의존성 검증 포함 공급망 보안 제어
      • SIEM 통합 모니터링 및 탐지 제어
      • 자동화 기능 포함 사고 대응 및 복구
    • 구현 예제: 상세 YAML 구성 블록 및 코드 예제 추가
    • Microsoft 솔루션 통합: Azure 보안 서비스, GitHub Advanced Security, 엔터프라이즈 아이덴티티 관리 종합 수록

고급 주제 보안 (05-AdvancedTopics/mcp-security/) - 프로덕션 구현

  • README.md: 엔터프라이즈 보안 구현을 위한 완전 재작성
    • 최신 사양 정렬: MCP Specification 2025-06-18 기반 필수 보안 요구 사항 업데이트
    • 강화된 인증: Microsoft Entra ID 통합 및 .NET, Java Spring Security 종합 예제 제공
    • AI 보안 통합: Microsoft Prompt Shields, Azure Content Safety 구현 및 상세 Python 예제 포함
    • 고급 위협 완화: 상세 구현 예제
      • PKCE 및 사용자 동의 검증 포함 Confused Deputy 공격 방지
      • 청중 검증 및 안전한 토큰 관리 토큰 패스스루 방지
      • 암호화 바인딩 및 행동 분석 세션 탈취 방지
    • 엔터프라이즈 보안 통합: Azure Application Insights 모니터링, 위협 탐지 파이프라인, 공급망 보안
    • 구현 체크리스트: 필수 대 권장 보안 제어를 명확히 구분, Microsoft 보안 생태계 장점 강조

문서 품질 및 표준 정렬

  • 사양 참조: 모든 문서가 MCP Specification 2025-06-18 기준으로 업데이트됨
  • Microsoft 보안 생태계: 보안 문서 전반에 강화된 통합 지침 수록
  • 실제 구현: .NET, Java, Python 언어별 상세 코드 예제와 엔터프라이즈 패턴 포함
  • 자원 구성: 공식 문서, 보안 표준, 구현 가이드별로 체계적 분류
  • 시각 표시: 필수 요구사항과 권장 관행 명확한 구분 표시

핵심 개념 (01-CoreConcepts/) - 완전 현대화

  • 프로토콜 버전 업데이트: MCP Specification 2025-06-18, YYYY-MM-DD 형식 버전 참조로 업데이트
  • 아키텍처 정교화: 현재 MCP 아키텍처 패턴 반영하여 호스트, 클라이언트, 서버 설명 강화
    • 호스트는 이제 여러 MCP 클라이언트 연결을 조정하는 AI 애플리케이션으로 명확히 정의됨
    • 클라이언트는 일대일 서버 관계를 유지하는 프로토콜 커넥터로 설명됨
    • 서버는 로컬 대 원격 배포 시나리오로 향상됨
  • 기본 원시 구조 재편성: 서버와 클라이언트 원시 구조 완전 개편
    • 서버 원시 구조: 리소스(데이터 소스), 프롬프트(템플릿), 도구(실행 가능한 함수) 상세 설명 및 예시 포함
    • 클라이언트 원시 구조: 샘플링(LLM 완성), 유도(사용자 입력), 로깅(디버깅/모니터링)
    • 현재 탐색(*/list), 검색(*/get), 실행(*/call) 메서드 패턴으로 업데이트
  • 프로토콜 아키텍처: 2계층 아키텍처 모델 도입
    • 데이터 계층: JSON-RPC 2.0 기반, 수명주기 관리 및 원시 구조 포함
    • 전송 계층: STDIO(로컬) 및 SSE가 포함된 스트림형 HTTP(원격) 전송 메커니즘
  • 보안 프레임워크: 명시적 사용자 동의, 데이터 프라이버시 보호, 도구 실행 안전, 전송 계층 보안 등 포괄적 보안 원칙
  • 통신 패턴: 초기화, 탐색, 실행 및 알림 흐름을 보여주는 프로토콜 메시지 업데이트
  • 코드 예제: MCP SDK 현재 패턴 반영하여 다중 언어(.NET, Java, Python, JavaScript) 예제 갱신

보안 (02-Security/) - 포괄적 보안 대대적 개편

  • 표준 정렬: MCP 사양 2025-06-18 보안 요구사항 완전 정렬
  • 인증 진화: 커스텀 OAuth 서버에서 외부 ID 제공자 위임(마이크로소프트 Entra ID)까지 진화 문서화
  • AI 특화 위협 분석: 최신 AI 공격 벡터 강화 적용
    • 실제 사례를 포함한 상세 프롬프트 인젝션 공격 시나리오
    • 도구 오염 메커니즘 및 "러그 풀" 공격 패턴
    • 컨텍스트 윈도우 오염 및 모델 혼동 공격
  • 마이크로소프트 AI 보안 솔루션: 마이크로소프트 보안 생태계의 포괄적 적용
    • 고급 탐지, 조명 및 구분자 기술을 포함한 AI 프롬프트 쉴드
    • Azure 콘텐츠 안전 통합 패턴
    • 공급망 보호를 위한 GitHub 고급 보안
  • 고급 위협 완화: 상세 보안 제어
    • MCP 특화 공격 시나리오와 암호화 세션 ID 요구사항 포함 세션 하이재킹
    • 명시적 동의 요구사항 갖춘 MCP 프록시 혼란 데퓨티 문제
    • 필수 검증 통제와 함께하는 토큰 패스스루 취약점
  • 공급망 보안: 기초 모델, 임베딩 서비스, 컨텍스트 제공자, 제3자 API 등 AI 공급망 범위 확대
  • 기초 보안: 제로 트러스트 아키텍처 및 마이크로소프트 보안 생태계 포함 엔터프라이즈 보안 패턴과의 통합 강화
  • 리소스 구성: 유형별(공식 문서, 표준, 연구, 마이크로소프트 솔루션, 구현 가이드) 포괄적 리소스 링크 분류

문서 품질 향상

  • 구조화된 학습 목표: 구체적이고 실행 가능한 결과를 갖춘 학습 목표 강화
  • 상호 참조: 보안 및 핵심 개념 주제 간 링크 추가
  • 최신 정보 반영: 모든 날짜 참조 및 사양 링크를 최신 표준으로 업데이트
  • 구현 지침: 양 섹션 전반에 구체적이고 실행 가능한 구현 가이드 추가

2025년 7월 16일

README 및 탐색 개선

  • README.md 내 커리큘럼 탐색 완전 재설계
  • <details> 태그를 더 접근성 좋은 테이블 기반 형식으로 교체
  • 새 "alternative_layouts" 폴더에 대체 레이아웃 옵션 생성
  • 카드 기반, 탭 스타일, 아코디언 스타일 탐색 예제 추가
  • 최신 파일을 모두 포함하도록 저장소 구조 섹션 업데이트
  • "이 커리큘럼 사용법" 섹션 명확한 권장사항 추가
  • MCP 사양 링크를 올바른 URL로 업데이트
  • 커리큘럼 구조에 컨텍스트 엔지니어링 섹션(5.14) 추가

학습 가이드 업데이트

  • 현 저장소 구조에 맞게 학습 가이드 완전 개정
  • MCP 클라이언트 및 도구, 대중적인 MCP 서버에 대한 새 섹션 추가
  • 모든 주제를 정확히 반영하도록 시각 커리큘럼 맵 업데이트
  • 고급 주제 설명을 모든 전문 영역까지 확대
  • 실제 사례를 반영하도록 사례 연구 섹션 업데이트
  • 이 포괄적 변경 로그 추가

커뮤니티 기여 (06-CommunityContributions/)

  • 이미지 생성용 MCP 서버에 대한 상세 정보 추가
  • VSCode에서 Claude 사용에 관한 포괄적 섹션 추가
  • Cline 터미널 클라이언트 설정 및 사용법 문서화
  • 모든 대중적인 클라이언트 옵션 포함하도록 MCP 클라이언트 섹션 업데이트
  • 보다 정확한 코드 예제로 기여 예제 강화

고급 주제 (05-AdvancedTopics/)

  • 일관된 명명을 갖춘 모든 전문 주제 폴더 정리
  • 컨텍스트 엔지니어링 자료 및 예제 추가
  • Foundry 에이전트 통합 문서 추가
  • Entra ID 보안 통합 문서 강화

2025년 6월 11일

초기 제작

  • MCP for Beginners 커리큘럼 첫 버전 출시
  • 10개 주요 섹션 기본 구조 생성
  • 탐색용 시각 커리큘럼 맵 구현
  • 다중 프로그래밍 언어 초기 샘플 프로젝트 추가

시작하기 (03-GettingStarted/)

  • 첫 서버 구현 예제 생성
  • 클라이언트 개발 가이드 추가
  • LLM 클라이언트 통합 지침 포함
  • VS Code 통합 문서 추가
  • Server-Sent Events (SSE) 서버 예제 구현

핵심 개념 (01-CoreConcepts/)

  • 클라이언트-서버 아키텍처 상세 설명 추가
  • 주요 프로토콜 구성 요소 문서화
  • MCP 내 메시징 패턴 문서 작성

2025년 5월 23일

저장소 구조

  • 기본 폴더 구조로 저장소 초기화
  • 주요 섹션별 README 파일 생성
  • 번역 인프라 설정
  • 이미지 자산 및 다이어그램 추가

문서화

  • 커리큘럼 개요 포함 초기 README.md 작성
  • CODE_OF_CONDUCT.md 및 SECURITY.md 추가
  • 지원 안내 포함 SUPPORT.md 설정
  • 초기 학습 가이드 구조 작성

2025년 4월 15일

기획 및 프레임워크

  • MCP for Beginners 커리큘럼 초기 기획
  • 학습 목표 및 대상 정의
  • 10개 섹션 구조 개요 작성
  • 예제 및 사례 연구 개념적 프레임워크 개발
  • 주요 개념에 대한 초기 프로토타입 예제 생성

면책 조항: 이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 위해 노력하고 있으나, 자동 번역은 오류나 부정확성이 포함될 수 있음을 유의하시기 바랍니다. 원본 문서가 권위 있는 출처로 간주되어야 합니다. 중요한 정보의 경우에는 전문적인 인간 번역을 권장합니다. 본 번역의 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.