Home / Guide

MCP 서버 만들기
완전 가이드

AI가 직접 도구를 사용할 수 있게 만드는 MCP(Model Context Protocol), 그리고 AI와 대화하며 코드를 완성하는 바이브 코딩. 처음이라도 괜찮습니다. 이 가이드가 처음부터 끝까지 안내합니다.

10 min read
Beginner-friendly
001 What is MCP

MCP란 무엇인가?

MCP(Model Context Protocol)는 AI가 외부 도구를 사용할 수 있게 해주는 표준 규격입니다. ChatGPT나 Claude 같은 AI는 똑똑하지만, 혼자서는 날씨를 조회하거나 파일을 저장할 수 없습니다. MCP 서버를 만들면, AI가 당신이 만든 도구를 직접 호출해서 쓸 수 있게 됩니다.

Before MCP

AI는 말만 잘하는 존재

"오늘 서울 날씨 알려줘"라고 물으면, AI는 추측하거나 과거 데이터를 알려줍니다. 실시간으로 날씨 API를 호출할 수 없기 때문입니다.

After MCP

AI에게 손발이 생김

MCP 서버에 "날씨 조회" 도구를 만들어두면, AI가 직접 API를 호출하고 실시간 데이터를 가져와 답변할 수 있습니다.

핵심 개념: Tool Calling

MCP의 핵심은 Tool Calling입니다. AI에게 "이런 도구가 있어"라고 알려주면, AI가 상황에 맞게 도구를 선택하고 호출합니다. 당신은 도구를 만들기만 하면 됩니다. 언제 호출할지는 AI가 알아서 판단합니다.

구분 일반 AI MCP가 있는 AI
날씨 질문 학습 데이터 기반 추측 실시간 API 호출 후 정확한 답변
메모 저장 불가능 파일이나 DB에 직접 저장
번역 요청 내부 모델로 번역 (제한적) 전문 번역 API 연동 가능
확장성 제한적 도구를 추가할수록 AI가 더 강력해짐
002 Vibe Coding

바이브 코딩이란?

바이브 코딩(Vibe Coding)은 개발자가 직접 코드를 한 줄씩 작성하는 대신, AI에게 원하는 기능을 설명하면 AI가 코드를 작성해주는 새로운 개발 방식입니다. 프로그래밍 문법을 몰라도, 원하는 것을 명확하게 설명할 수 있으면 코드를 만들 수 있습니다.

Traditional

전통적인 코딩

프로그래밍 언어 문법을 배우고, 함수를 직접 작성하고, 디버깅까지 혼자 해야 합니다. 배우는 데 수개월이 걸릴 수 있습니다.

Vibe Coding

바이브 코딩

AI에게 "덧셈 함수 만들어줘"라고 말하면, AI가 코드를 작성합니다. 결과를 확인하고, 수정할 부분을 다시 AI에게 요청하면 됩니다.

바이브 코딩 + MCP = AI Agent 개발

바이브 코딩으로 MCP 서버를 만들면, 결과물은 AI Agent입니다. AI가 사용할 도구를, AI와 대화하면서 만드는 것입니다. 코딩을 몰라도 시작할 수 있고, 하면 할수록 더 복잡한 Agent를 만들 수 있게 됩니다.

003 Structure

MCP 서버는 이렇게 생겼습니다

MCP 서버는 Python 클래스 하나로 만들 수 있습니다. 클래스 안에 도구(함수)를 정의하고, 각 도구가 무슨 일을 하는지 설명하면 됩니다. 아래는 가장 간단한 MCP 서버 예시입니다.

Python — 인사하기 MCP 서버
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("hello-server")

@mcp.tool()
def greet(name: str) -> dict:
    """이름을 받아 인사말을 반환합니다."""
    return {"message": f"안녕하세요, {name}님! 반갑습니다."}

if __name__ == "__main__":
    mcp.run(transport="stdio")

코드 설명

FastMCP: MCP 서버를 쉽게 만들 수 있는 Python 라이브러리입니다.
@mcp.tool(): 이 함수가 "AI가 호출할 수 있는 도구"라는 표시입니다.
greet(name): AI가 사용자의 이름을 넣어 호출하면, 인사말을 돌려줍니다.
mcp.run(): 서버를 실행합니다. AI와 통신할 준비 완료.

Python — 덧셈 MCP 서버
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("math-server")

@mcp.tool()
def add(a: float, b: float) -> dict:
    """두 수를 더해 결과를 반환합니다."""
    return {"result": a + b}

if __name__ == "__main__":
    mcp.run(transport="stdio")
004 Getting Started

어떻게 시작하나요?

이 플랫폼에서는 브라우저만 있으면 바로 MCP 서버를 만들고 테스트할 수 있습니다. 설치할 것도, 환경 설정도 필요 없습니다.

1

회원가입

이메일 하나로 간단히 가입할 수 있습니다. 별도 인증 절차 없이 바로 시작합니다.

2

튜토리얼 문제부터 시작

1번~3번 문제는 튜토리얼입니다. 코드가 이미 완성되어 있으므로, 아무것도 수정하지 않고 '채점' 버튼만 누르면 통과됩니다. MCP 서버가 어떻게 동작하는지 먼저 감을 잡으세요.

3

AI와 대화하며 풀기

풀이 화면 오른쪽에 AI 어시스턴트가 있습니다. 막히면 AI에게 질문하세요. 코드를 분석하고, 힌트를 주고, 디버깅을 도와줍니다. AI 사용은 무료입니다.

4

채점 & 성장

코드가 완성되면 '채점' 버튼을 누르세요. GPT가 실제로 AI Agent를 실행해서 도구를 호출하고, 결과가 올바른지 자동으로 확인합니다. 점수가 랭킹에 반영됩니다.

005 Problem Examples

어떤 문제가 있나요?

100개 이상의 문제가 난이도별로 준비되어 있습니다. 쉬운 문제부터 시작해서, 점점 복잡한 AI Agent를 만들어 보세요.

Easy

인사하기 서버

이름을 받아 인사말을 돌려주는 가장 기본적인 MCP 서버.

Easy

덧셈 서버

두 수를 받아 더한 결과를 반환하는 계산 도구.

Easy

메아리 서버

입력받은 메시지를 그대로 돌려주거나 뒤집어서 반환하는 서버.

Medium

날씨 조회기

도시 이름을 받아 현재 날씨와 온도를 알려주는 AI 도구.

Medium

번역기

텍스트와 대상 언어를 입력하면 번역 결과를 돌려주는 서버.

Hard

개인 비서 Agent

일정 관리, 알림, 메모 등 여러 도구를 결합한 복합 Agent.

006 FAQ

자주 묻는 질문

코딩을 전혀 몰라도 할 수 있나요?

+

네. 바이브 코딩은 AI에게 원하는 것을 설명하면 AI가 코드를 작성해줍니다. 프로그래밍 언어를 몰라도 시작할 수 있고, 튜토리얼 문제는 코드를 수정하지 않아도 통과됩니다. 하면 할수록 코드가 눈에 들어오기 시작합니다.

AI 사용료가 있나요?

+

AI 어시스턴트는 무료로 제공됩니다. 채점도 문제당 5회까지 무료입니다. 더 강력한 AI 모델을 사용하고 싶다면 본인의 API 키를 연결할 수 있습니다.

채점은 어떻게 이루어지나요?

+

GPT가 실제로 AI Agent 역할을 합니다. 제출된 MCP 서버를 실행하고, AI가 도구를 호출해서 답변이 올바른지 확인합니다. 도구가 정상 동작하고 결과가 정확하면 합격입니다.

Python만 사용할 수 있나요?

+

현재는 Python만 지원합니다. Python은 AI/ML 분야에서 가장 널리 사용되는 언어이고, MCP 라이브러리도 Python이 가장 먼저 지원됩니다.

MCP를 배우면 어디에 쓸 수 있나요?

+

MCP는 Claude, ChatGPT 등 주요 AI에서 공식 지원하거나 지원 예정인 표준 프로토콜입니다. MCP 서버를 만들 수 있으면, 업무 자동화, 개인 비서, 데이터 분석 등 AI를 활용한 다양한 도구를 직접 만들어 사용할 수 있습니다.

바이브 코딩 대회 준비에도 도움이 되나요?

+

네. 최근 데이콘 바이브 코딩 경진대회, OCU AI 포럼 해커톤, 대구SW마이스터고 바이브 코딩 해커톤 등 바이브 코딩 콘테스트가 크게 늘고 있습니다. 이 플랫폼에서 MCP 서버를 만들고 채점받는 과정이 대회에서 요구하는 AI 도구 개발 역량을 키우는 데 직접적으로 도움이 됩니다. 난이도별로 100개 이상의 문제가 있어 체계적으로 준비할 수 있습니다.

바이브 코딩 해커톤에서 MCP 문제가 나오나요?

+

MCP는 AI Agent 개발의 핵심 프로토콜이기 때문에, 바이브 코딩 대회에서 AI 도구 연동이나 Agent 구축이 과제로 나올 때 MCP를 활용하면 유리합니다. 대회에서 "AI가 쓸 수 있는 도구를 만드세요"라는 요구가 나오면, 여기서 연습한 MCP 서버 구현 경험이 바로 적용됩니다.

지금 바로 시작하세요

튜토리얼 문제는 코드를 수정하지 않아도 통과됩니다. 먼저 감을 잡고, AI와 함께 점점 더 복잡한 문제에 도전하세요.

문제 풀러 가기
100+
Problems
Free
AI Grading
0
Setup
3
Tutorials