정적 텍스트 리소스 제공하기
모델이 읽을 수 있도록 고정된 문서를 노출합니다.
정적 텍스트 리소스 제공하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
고정 문서
가장 단순한 리소스는 정적 리소스입니다. 서버가 매번 반환하는 고정 문자열을 말합니다. 도움말, 정책 또는 config 메모에 적합합니다.
함수 하나, URI 하나
Python 함수를 작성하고 리소스 URI를 지정해 이를 공개합니다. 클라이언트가 해당 URI를 읽으면 함수가 실행되어 텍스트를 반환합니다.
데코레이터
리소스 데코레이터는 함수를 해당 URI에 등록합니다. 전달한 문자열이 클라이언트가 콘텐츠를 가져올 때 사용하는 주소가 됩니다.
@mcp.resource("info://welcome")
def welcome():
return "Welcome to the server!"일반 텍스트 반환
텍스트 리소스라면 Python 문자열을 반환하기만 하면 됩니다. SDK가 이를 적절한 MCP 읽기 응답으로 감싸므로 클라이언트는 깔끔한 콘텐츠를 받습니다.
이름 지정 및 설명 추가
모델이 언제 읽어야 하는지 알 수 있도록 리소스에 명확한 설명을 지정하세요. 함수의 독스트링이 해당 설명으로 사용됩니다.
@mcp.resource("info://welcome")
def welcome():
"Greeting shown to new users."
return "Hello there!"정적 리소스에는 입력이 없습니다
정적 리소스는 매개변수를 받지 않으며 항상 같은 본문을 반환합니다. 출력이 달라져야 한다면 나중에 다룰 템플릿을 사용해야 합니다.
코드에서 텍스트 만들기
전송하기 전에 Python에서 반환 값을 조합할 수 있습니다. 같은 호출이 같은 텍스트를 반환하므로 클라이언트 입장에서는 결과가 여전히 정적입니다.
@mcp.resource("config://limits")
def limits():
return "max_items=100\ntimeout=30"도구가 아닌 리소스를 사용하는 이유
모델이 컨텍스트를 읽기만 하면 될 때는 리소스를 사용하세요. 도구는 작업을 수행하기 위한 것이고, 참조 텍스트를 읽는 일은 바로 리소스의 역할입니다.
모델이 가져와 사용합니다
많은 호스트에서는 사용자가 리소스를 채팅에 첨부하여 콘텐츠를 컨텍스트에 넣을 수 있습니다. 그러면 모델은 프롬프트와 함께 해당 텍스트를 바탕으로 추론합니다.
가볍게 유지하기
정적 리소스는 별도의 작업이 없어 빠르게 로드됩니다. 모델에 토큰을 지나치게 많이 넣지 않도록 작고 안정적인 텍스트에 사용하세요.
리소스 테스트
서버를 실행하고 클라이언트를 사용해 URI를 나열한 다음 읽어 보세요. 작성한 문자열이 그대로 돌아오면 리소스 연결이 올바르다는 뜻입니다.
빠른 확인
고정 텍스트에 적합한 기본 요소를 선택해 보세요.
복습
정적 리소스는 URI 아래에 등록되어 고정 텍스트를 반환하는 함수입니다. 독스트링으로 설명을 추가하고 본문은 작게 유지하세요. 📄
자주 묻는 질문
“정적 텍스트 리소스 제공하기” 강의는 무료인가요?
네 — “정적 텍스트 리소스 제공하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“정적 텍스트 리소스 제공하기”에서 뭘 배우나요?
모델이 읽을 수 있도록 고정된 문서를 노출합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MCP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“정적 텍스트 리소스 제공하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 리소스 URI 이해하기
- 정적 텍스트 리소스 제공하기
- 디스크에서 파일 읽기
- 올바른 MIME 유형 설정하기