MCP 초급 과정 - AI의 만능 연결 포트

🚀 MCP 초급 과정 - AI의 만능 연결 포트

MCP란 무엇인가요?

MCP (Model Context Protocol)는 AI가 다양한 도구와 데이터에 연결될 수 있게 해주는 표준 프로토콜입니다. 마치 USB 포트처럼, MCP를 통해 AI는 파일 시스템, 데이터베이스, 웹 서비스 등 다양한 외부 자원에 접근할 수 있습니다.

💡 간단히 말하면: AI가 당신의 컴퓨터, 앱, 서비스와 대화할 수 있게 만드는 연결 통로입니다!

0%

📚 학습 목표

• MCP의 기본 개념 이해하기
• 간단한 MCP 서버 설정하기
• 첫 번째 MCP 도구 사용해보기
• 실제 예제로 MCP 활용하기

실습 1

완료

MCP 개념 이해하기

1단계: MCP의 3가지 핵심 요소

• MCP 서버: 도구와 데이터를 제공하는 프로그램
• MCP 클라이언트: AI 애플리케이션 (예: Claude Desktop)
• 프로토콜: 둘 사이의 통신 규칙

2단계: 실생활 비유로 이해하기

레스토랑을 생각해보세요:

• 손님 (AI/클라이언트): 음식을 주문합니다
• 메뉴판 (MCP 프로토콜): 어떤 음식을 주문할 수 있는지 알려줍니다
• 주방 (MCP 서버): 실제로 음식을 만들어 제공합니다

💡 핵심 포인트

MCP는 AI가 "할 수 있는 것"을 확장합니다. 단순히 텍스트 생성을 넘어, 실제로 작업을 수행할 수 있게 됩니다!

실습 2

완료

Claude Desktop에서 MCP 설정하기

1단계: 설정 파일 위치 찾기

운영체제별 설정 파일 위치:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

2단계: 기본 설정 파일 구조 이해하기

{ "mcpServers": { "서버이름": { "command": "실행할_명령어", "args": ["인자1", "인자2"] } } }

⚠️ 주의사항

설정 파일을 수정한 후에는 반드시 Claude Desktop을 재시작해야 변경사항이 적용됩니다!

실습 3

완료

첫 번째 MCP 서버 설치하기 - Filesystem

1단계: Node.js 설치 확인

터미널을 열고 다음 명령어를 실행하세요:

node --version

버전이 표시되면 설치되어 있는 것입니다. 없다면 nodejs.org에서 다운로드하세요.

2단계: MCP Filesystem 서버 설치

npx @modelcontextprotocol/server-filesystem

3단계: Claude Desktop 설정 파일 편집

설정 파일에 다음 내용을 추가하세요:

{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/당신의사용자명/Documents" ] } } }

중요: /Users/당신의사용자명/Documents 부분을 실제 접근하고 싶은 폴더 경로로 변경하세요!

4단계: Claude Desktop 재시작

애플리케이션을 완전히 종료하고 다시 실행하세요.

실습 4

완료

MCP 기능 테스트하기

1단계: 연결 확인

Claude Desktop을 열고 다음과 같이 질문해보세요:

"Documents 폴더에 어떤 파일들이 있어?"

2단계: 파일 읽기 테스트

특정 파일의 내용을 확인해보세요:

"test.txt 파일의 내용을 읽어줘"

3단계: 파일 생성 테스트

새로운 파일을 만들어보세요:

"Documents 폴더에 'hello.txt'라는 파일을 만들고 '안녕하세요, MCP!'라고 써줘"

✅ 성공 확인

Claude가 실제로 파일을 생성하고, 읽고, 나열할 수 있다면 MCP가 정상적으로 작동하는 것입니다!

실습 5

완료

실전 예제: 일기 관리 시스템 만들기

1단계: 일기 폴더 준비

Documents 폴더 안에 'MyDiary' 폴더를 만드세요.

2단계: MCP 설정 업데이트

일기 폴더를 MCP 서버 경로에 추가:

{ "mcpServers": { "diary": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/당신의사용자명/Documents/MyDiary" ] } } }

3단계: AI에게 일기 작성 요청

Claude에게 다음과 같이 요청해보세요:

"오늘 날짜로 일기 파일을 만들고, '오늘은 MCP를 처음 배웠다. 정말 신기하다!'라고 써줘"

4단계: 일기 검색하기

"지난주에 쓴 일기들을 모두 찾아줘"

5단계: 일기 요약하기

"이번 달 일기들을 읽고 한 줄로 요약해줘"

🎯 실습 목표

이 예제를 통해 MCP가 단순히 파일을 다루는 것을 넘어, 실생활에서 유용한 도구로 활용될 수 있음을 경험하게 됩니다!

🎓 초급 과정 완료 후 할 수 있는 것

• ✅ MCP의 기본 개념과 작동 원리 이해
• ✅ Claude Desktop에서 MCP 서버 설정 및 관리
• ✅ Filesystem 서버를 통한 파일 읽기/쓰기/관리
• ✅ 간단한 자동화 작업 수행

🚀 다음 단계

중급 과정에서는 다음을 배웁니다:

• 데이터베이스 연결 (SQLite, PostgreSQL)
• 웹 API와 통합하기
• 여러 MCP 서버 동시에 사용하기
• 나만의 커스텀 MCP 서버 만들기