AI导哈

MCP服务器资源管理

MCP服务器提供资源发现和管理功能，支持通过URI或模板访问资源，并集成LLM交互的标准化提示模板。

  • by kwonci
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kwonci/tutorial-weathermcp

使用说明

MCP Tutorials

Reference

https://modelcontextprotocol.io/quickstart/server

  • [v] 튜토리얼에서 제공한 mcp 서버를 cline을 통해서 사용해보기
  1. cline에서 에러가 발생했다고 하는데, cline에서 debug level의 로그를 내는 과정에서 성공한 에러까지 stderr로 내는 것 아닐까 추정, loglevel을 error로 만드니 해결(링크)
  • [] Tools에 argument에 대한 설명이 제대로 뜨지 않음, 이슈인지 아닌지 확인 필요
  • [v] Python linter와 formatter 다시 설치(-> ruff로 설치)

API 요청을 안 사용하지는 않는다. (나의 요청 + MCP 서버들이 제공하는 tools)를 LLM이 보고 판단하여서, 알아서 실행시키고 이 과정에서 API 요청이 2회 발생. $0.05, $0.03. 어쨌거나 tools를 잘 이용해서 가져오는 걸 알 수 있었다.

  1. 예제들 확인해보기
  • filesystem: tools 사용
  • drive: resources 사용. -> resources로 가능한 모든 operation은 tools로도 가능하나 다른 abstraction을 제공(REST API의 GET과 POst 정도의 차이로 이해)

예제 추가

Python SDK 에 있는 내용들 이해하기

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

  1. Resource의 정의

https://modelcontextprotocol.io/docs/concepts/resources#resource-templates

Any kinds of data that an MCP server wants to make available to MCP clients.

  • Resource discovery(MCP clients는 MCP server에 available한 resource를 어떻게 알아내는가)
    • direct resources: resources/list 엔드포인트를 통해 아래의 형식으로 리소스들을 노출
{
  uri: string;  // Unique identifier of the resource
  name: string; // human-readable name of resource
  description?: string; // optional description
  mimeType?: string; // optionam mimetype
}
  • resource templates: uritemplate을 통해 제공하는 리소스들을 노출
{
  uriTemplate: string;   // URI template following RFC 6570
  name: string;          // Human-readable name for this type
  description?: string;  // Optional description
  mimeType?: string;     // Optional MIME type for all matching resources
}
  • MCP client가 resource discovery를 통해, available한 resources를 mcp server로부터 불러왔다면, 어떤 식으로 호출할 수 있을까?
    • resource read handler를 정의하는 방법은 두 가지
      • @mcp.resource()를 통해 uri를 입력받는 함수를 decorate하면서 정의
      • 혹은 @mcp.resource(uri_template)을 통해서 정의

정리하자면, mcpserver은 resource discovery가 가능하도록 리소스의 URI를 직접, 혹은 템플릿을 통해 노출한다. mcpclients는 available한 resource를 discover한 후 URI를 통해 해당 리소스를 요청할 수 있다.

  1. Prompts 정의

목적에 맞는 prompts의 제공: 서버에게 재사용 가능한 prompts template을 제공하여 LLM interactions 간 표준화된 방법을 제공(user-controlled이고, user가 explicit하게 prmopts를 선택할 수 있는 것이 의도)

구현해야하는 API

  • prompts discovery

    • returns: (name, description, arguments)

  • prompts usage

    • args: (name, arguments declared in prompts)
    • returns: prompts(dynamic(resource 기반의 prmopts), multiple도 가능)
  1. Image 반환

Image 반환 기능 존재

相关 MCP