초보자용 · 직접 해보는 가이드

AI에게 새로운 손을 달아주는
MCP 서버 만들기

MCP 서버는 AI가 쓸 수 있는 "도구 상자"예요. 그림으로 구조를 이해하고, 코드 몇 줄로 만드는 법을 배운 뒤, 시뮬레이터에서 AI와 서버가 실제로 어떤 메시지를 주고받는지 한 단계씩 지켜보세요.

1MCP란 무엇일까요?

MCP(Model Context Protocol)는 AI 앱과 외부 도구·데이터를 연결하는 공통 규칙이에요. 어떤 기기든 꽂으면 되는 USB-C 포트처럼, 규칙만 지키면 Claude 같은 AI 앱 어디에서나 내 서버를 쓸 수 있어요.

👤 사용자 "서울 날씨 알려줘" 🤖 AI 앱 (호스트) Claude 데스크톱 등 MCP 클라이언트 🛠️ MCP 서버 ← 우리가 만들 것! 도구 · 리소스 · 프롬프트 🌤 날씨 API 🗄 데이터베이스 📁 내 파일 요청 결과 MCP 규칙 (JSON-RPC)
🧑‍🍳 식당으로 비유하면손님이 주문하면 웨이터가 주방에 전달하고, 주방이 요리를 만들어요.
손님사용자원하는 걸 말로 요청해요.
웨이터AI 앱메뉴판(도구 목록)을 보고 어떤 요리를 주문할지 판단해요.
주방MCP 서버실제 일을 처리하고 결과를 돌려줘요.

2서버가 제공할 수 있는 3가지

처음에는 도구(Tools)만 만들어도 충분해요. 가장 많이 쓰이고, 시뮬레이터에서도 도구를 다뤄요.

🔧
가장 중요

도구 (Tools)

AI가 스스로 판단해서 실행하는 함수예요. 계산하기, 검색하기, 메일 보내기처럼 "행동"을 해요.

get_weather(city="서울")
→ "맑음, 18°C"
📄
읽기 전용

리소스 (Resources)

AI가 참고로 읽는 자료예요. 파일 내용, 설정값, 문서처럼 주소(URI)로 꺼내 봐요.

config://app-settings
→ 앱 설정 내용
💬
사용자가 선택

프롬프트 (Prompts)

자주 쓰는 질문 틀(템플릿)이에요. 사용자가 메뉴에서 골라 바로 쓸 수 있어요.

"코드 리뷰해줘: {코드}"

35단계로 만들어 보기

언어를 고르고 단계를 하나씩 따라가세요. Python이 가장 짧고 쉬워요.

4시뮬레이터: 직접 만들고 돌려보기

왼쪽에서 서버에 넣을 도구를 켜고 설명을 바꿔보세요. 오른쪽에서 AI에게 질문하면 메시지가 오가는 과정이 한 단계씩 그려져요. 화살표를 누르면 실제 주고받는 JSON을 볼 수 있어요.

🛠️ 내 MCP 서버

도구 2개
💡설명(description)이 핵심! AI는 코드를 보지 못하고 이름과 설명만 보고 도구를 고릅니다. 설명을 지우면 어떻게 될까요?
📜 자동으로 만들어지는 코드
server.py

      

💬 AI에게 질문하기

가상 실행
아래 예시를 누르거나 직접 질문을 입력하세요
👤사용자
🤖AI 앱클라이언트
🛠️MCP 서버my-first-server
질문을 보내면 이곳에 메시지 흐름이 그려져요
🎯 미션 (0/4)

    5서버를 연결하는 두 가지 방식

    같은 코드라도 실행 방식(전송 방식)에 따라 내 컴퓨터용과 인터넷용으로 나뉘어요.

    처음엔 이걸로

    💻 stdio (표준 입출력)

    AI 앱이 내 컴퓨터에서 서버 프로그램을 직접 실행하고, 입력·출력 창구로 대화해요. 설정이 가장 간단해요.

    Python
    mcp.run()  # 기본값이 stdio
    ⚠️stdio 서버에서는 print()로 화면에 출력하면 안 돼요. 출력 창구가 곧 통신선이라 메시지가 깨집니다. 로그는 stderr로 남기세요.
    여러 사람이 쓸 때

    🌐 Streamable HTTP

    서버를 웹 주소(URL)로 띄워서 원격으로 접속해요. 팀이나 외부 사용자가 함께 쓰는 서비스에 적합해요.

    Python
    mcp.run(transport="http", port=8000)
    🔐인터넷에 공개할 땐 인증, 입력값 검증, 권한 최소화를 꼭 챙기세요. 도구는 AI가 스스로 실행하니까요.

    6확인 퀴즈

    세 문제만 맞히면 MCP 서버의 핵심은 다 이해한 거예요.