Hello 도구 추가하기
인공지능이 호출할 수 있도록 Python 함수에 장식자를 적용해 보세요.
Hello 도구 추가하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
서버에 기능 부여하기
도구가 없는 서버는 껍데기에 불과합니다. 도구는 AI가 사용자를 위해 실제 작업을 수행하도록 호출할 수 있는 Python 함수입니다. 🛠️
마법 같은 데코레이터
FastMCP에서는 함수 정의 바로 위에 @mcp.tool() 데코레이터를 한 줄 추가하여 함수를 도구로 공개합니다.
@mcp.tool()
def hello():
...일반적인 함수 작성하기
본문은 그저 Python 코드입니다. 특별한 프로토콜 코드나 직접 작성한 JSON은 필요하지 않습니다. 도구가 해야 할 일을 작성하고 값을 반환하면 됩니다.
@mcp.tool()
def hello():
return "Hello from MCP!"매개변수 추가하기
입력을 받으면 도구가 더 유용해집니다. 매개변수를 추가하면 모델이 도구를 호출하기로 결정했을 때 값을 전달할 수 있습니다.
@mcp.tool()
def greet(name):
return "Hello, " + name형식 힌트로 스키마 만들기
name: str과 같은 형식 힌트를 추가하면 FastMCP가 이를 입력 스키마로 변환합니다. 그러면 모델은 어떤 종류의 값을 보내야 하는지 정확히 알 수 있습니다.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + name독스트링이 설명이 됩니다
함수의 독스트링이 도구의 설명이 됩니다. 모델은 이를 읽고 이 도구를 사용하기에 적절한 시점을 판단합니다.
@mcp.tool()
def greet(name: str) -> str:
"""Greet a person by name."""
return "Hello, " + name함수에서 이름 가져오기
기본적으로 도구의 이름은 함수 이름입니다. 따라서 def greet는 클라이언트에 "greet"라는 이름으로 표시되는 도구를 공개합니다.
일반 텍스트 반환하기
첫 번째 도구에서는 문자열을 반환하기만 하면 됩니다. FastMCP가 이를 적절한 MCP 결과 형식으로 감싸므로 클라이언트는 깔끔한 텍스트를 받습니다.
잘 설명하기
표현을 잘 작성하는 것이 중요합니다. 명확한 설명이 있으면 모델이 적절한 순간에 도구를 선택할 수 있습니다. 모호한 독스트링은 호출 누락으로 이어집니다.
자동으로 등록됩니다
직접 등록 함수를 호출할 필요는 없습니다. 데코레이터를 붙이는 것만으로 도구가 mcp 인스턴스에 등록되고 공개할 준비가 됩니다.
원하는 만큼 추가하기
하나의 서버에 여러 도구를 담을 수 있습니다. 각 함수에 데코레이터를 붙이면 클라이언트가 사용 가능한 항목을 요청할 때 모든 도구가 함께 표시됩니다.
빠른 확인
도구의 설명은 어디에서 가져오나요?
복습
@mcp.tool()로 도구를 추가하고, 형식이 지정된 매개변수를 제공했으며, 독스트링으로 도구를 설명하게 했습니다. 이제 서버가 실제로 작업을 수행할 수 있습니다. 이제 실행해 보겠습니다! ✨
AI 튜터와 함께 Python을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 30
- 레슨
- 120
자주 묻는 질문
“Hello 도구 추가하기” 강의는 무료인가요?
네 — “Hello 도구 추가하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“Hello 도구 추가하기”에서 뭘 배우나요?
인공지능이 호출할 수 있도록 Python 함수에 장식자를 적용해 보세요. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MCP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“Hello 도구 추가하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- FastMCP 인스턴스 만들기
- Hello 도구 추가하기
- stdio로 서버 실행하기
- 로드 및 도구 목록 표시 확인하기