MCP 教程概述

参考资料

https://modelcontextprotocol.io/quickstart/server

• [已完成] 튜토리얼에서 제공한 MCP 서버를 cline을 통해 사용해 보기
  • 에러 해결: cline에서 디버그 레벨의 로그를 출력할 때, 에러까지 stderr로 내는 문제가 있었다고 추정됩니다. 이에 loglevel을 error로 설정하여 문제를 해결했습니다(링크).
  • 툴즈 설명: Tools의 인자 설명이 완전히 제대로 뜨지 않는 문제가 있습니다. 이는 이슈인지 아닌지 확인 필요합니다.
• [已完成] PythonLint Checker 및 Formatter 다시 설치(-> ruff로 설치).

비고: API 요청을 사용하지 않습니다. (내가 하는 요청 + MCP 서버들이 제공하는 tools)를 LLM이 보고 판단하여, 알아서 실행시키는 과정에서 API 요청이 최대 2회 발생합니다. 비용은 $0.05, $0.03 정도로预상됩니다. 어쨌거나 tools를 잘 활용하여 필요한 데이터를 가져올 수 있습니다.

예제 추가

Python SDK의 내용을 이해하기 위해 아래 링크 참조:

https://github.com/modelcontextprotocol/python-sdk

1. Resource 정의

MCP 서버가 MCP 클라이언트에게 제공하려는 리소스의 정의입니다.

• 리소урс 디스커버리(MCP 클라이언트가 MCP 서버에서 사용할 수 있는 리소르스를 어떻게 알아내는가?)
  • 직접적인 리소르스: resources/list 엔드포인트를 통해 아래와 같은 형식으로 리소르스들을 노출시킵니다.

{
  uri: string;  // Unique identifier of the resource (리소урс의 고유 식별자)
  name: string; // 인간이 읽을 수 있는 리소урс 이름
  description?: string; // 선택적으로 제공되는 설명
  mimeType?: string; // 선택적으로 제공되는 MIME 타입
}

• 리소урс 템플릿: uritemplate을 통해 제공하는 리소르스들을 노출시킵니다.

{
  uriTemplate: string;   // RFC 6570 규격에 따른 URI 템플릿
  name: string;          // 이 유형의 인간이 읽을 수 있는 이름
  description?: string;  // 선택적으로 제공되는 설명
  mimeType?: string;     // 모든 일치하는 리소르스에 대한 선택적인 MIME 타입
}

• MCP 클라이언트가 리소урс 디스커버리를 통해 MCP 서버에서 사용할 수 있는 리소르스를 불러온다면, 어떤 방법으로 호출할 수 있을까?
  • 리소урс 레드 핸들러를 정의하는 방법은 아래와 같습니다:
    • @mcp.resource()데코레이터를 통해 uri를 입력받는 함수를裝飾자로 정의
    • 혹은 @mcp.resource(uri_template)을 통해 정의

정리: MCP 서버는 리소урс 디스커버리를 가능하게 하기 위해 리소르스의 URI를 직접적으로 제공하거나, 템플릿을 통해 노출시킵니다. MCP 클라이언트는 사용할 수 있는 리소르스를 발견한 후, 해당 URI를 통해 리소르스에 액세스할 수 있습니다.

2. Prompts 정의

목적에 맞는 prompts를 제공하여 LLM 인터랙션 간에 표준화된 방법을 제공합니다. 사용자는 명시적으로 prompts를 선택할 수 있습니다.

구현해야 하는 API:

• 프롬프트 디스커버리

  • 반환값: (name, description, arguments)

• 프롬프트 사용

  • 인자: (name, arguments declared in prompts)
  • 반환값: prompts(동적(resource 기반의 prompts), 다중도 지원)

3. 이미지 반환

이미지를 반환하는 기능이 존재합니다.

비고: MCP를 통해 제공되는 다양한 기능과 API를 활용하여 워크플로우를 구축하고, LLM이 데이터를 분석하고 처리할 수 있는 환경을 마련할 수 있습니다.