MCP의 리소스를 사용하면 서버가 도구 호출을 필요로 하지 않고도 프롬프트에 직접 포함될 수 있는 데이터를 노출할 수 있습니다. 이를 통해 Claude와 같은 AI 모델에 컨텍스트를 제공하는 더 효율적인 방법을 만들 수 있습니다.
리소스 요청 이해하기
MCP 서버에 리소스를 정의한 후에는, 클라이언트가 이를 요청하고 사용할 수 있는 방법이 필요합니다. 클라이언트는 애플리케이션과 MCP 서버 사이의 다리 역할을 하며, 통신과 데이터 파싱을 자동으로 처리합니다.

흐름은 간단합니다. 사용자가 문서를 참조하고 싶을 때(예: "@report.pdf"를 입력), 애플리케이션은 MCP 클라이언트를 사용하여 서버에서 해당 리소스를 가져오고, 그 내용을 Claude에게 전송되는 프롬프트에 직접 포함시킵니다.
리소스 읽기 구현하기
핵심 기능을 위해서는 MCP 클라이언트에 read_resource 함수가 필요합니다. 이 함수는 가져올 리소스를 식별하는 URI 매개변수를 받습니다:
async def read_resource(self, uri: str) -> Any:
result = await self.session().read_resource(AnyUrl(uri))
resource = result.contents[0]MCP 서버의 응답에는 contents 목록이 포함되어 있습니다. 일반적으로는 MIME 타입과 같은 메타데이터와 함께 실제 리소스 데이터를 포함하는 첫 번째 요소만 필요합니다.
다양한 콘텐츠 타입 처리하기
리소스는 다양한 타입의 콘텐츠를 반환할 수 있으므로, 클라이언트는 이를 적절하게 파싱해야 합니다. MIME 타입을 통해 데이터를 어떻게 처리해야 할지 알 수 있습니다:
if isinstance(resource, types.TextResourceContents):
if resource.mimeType == "application/json":
return json.loads(resource.text)
return resource.text이 접근 방식은 JSON 리소스가 Python 객체로 올바르게 파싱되도록 보장하며, 일반 텍스트 리소스는 문자열로 반환됩니다. MIME 타입은 올바른 파싱 전략을 결정하기 위한 힌트 역할을 합니다.
필요한 임포트
이 기능이 제대로 작동하려면 MCP 클라이언트에 다음 임포트가 필요합니다:
import json
from pydantic import AnyUrljson 모듈은 JSON 응답 파싱을 처리하고, AnyUrl은 URI 매개변수에 대한 적절한 타입 처리를 보장합니다.
리소스 접근 테스트하기
구현이 완료되면 CLI 애플리케이션을 통해 기능을 테스트할 수 있습니다. "What's in the @report.pdf document?"와 같은 내용을 입력하면 시스템은 다음과 같이 동작해야 합니다:
- 자동완성 목록에 사용 가능한 리소스 표시
- 리소스 선택 가능
- 리소스 콘텐츠 자동 가져오기
- 해당 콘텐츠를 Claude에게 전달되는 프롬프트에 포함

핵심 이점은 Claude가 문서 콘텐츠를 프롬프트에서 직접 받게 되어, 정보에 접근하기 위한 도구 호출이 필요 없어진다는 점입니다. 이를 통해 상호작용이 더 빠르고 효율적으로 이루어집니다.
애플리케이션과의 통합
작성한 MCP 클라이언트 코드는 애플리케이션의 다른 부분에서 사용된다는 점을 기억하세요. read_resource 함수는 다른 구성 요소가 문서 콘텐츠를 가져오거나, 사용 가능한 리소스를 나열하거나, 리소스 데이터를 프롬프트에 통합하기 위해 호출할 수 있는 빌딩 블록이 됩니다.
이러한 관심사의 분리는 코드를 깔끔하게 유지합니다. MCP 클라이언트는 서버와의 통신을 처리하고, 애플리케이션 로직은 해당 데이터를 효과적으로 활용하는 방법에 집중할 수 있습니다.