Tutorial Weathermcp

🚀 MCP 教程概述

本教程主要围绕 MCP（Model Context Protocol）展开，介绍了 MCP 服务器的使用、Python SDK 相关内容，包括资源定义、提示定义以及图像返回等功能，同时提及了参考资料和可能遇到的问题及解决办法。

🔗 参考资料

MCP 快速开始 - 服务器

已完成事项

• 使用 MCP 服务器：在教程中，通过 cline 尝试使用 MCP 服务器。
  • 错误解决：当 cline 输出调试级别的日志时，推测存在将错误信息也输出到 stderr 的问题。通过将 loglevel 设置为 error 解决了该问题（详情）。
  • 工具说明问题：Tools 的参数说明显示不完全正确，需要确认这是否为一个问题。
• 重新安装 PythonLint 检查器和格式化器：重新安装为 ruff。

注意：本教程不使用 API 请求。在 LLM 查看并判断（个人请求 + MCP 服务器提供的工具）后自动执行的过程中，API 请求最多会发生 2 次，预计费用分别为 $0.05 和 $0.03。无论如何，都可以通过合理使用工具来获取所需的数据。

💡 示例添加

为了理解 Python SDK 的内容，请参考以下链接： Python SDK

1. 📦 资源定义

这是 MCP 服务器向 MCP 客户端提供的 资源 的定义。

• 资源发现（MCP 客户端如何发现 MCP 服务器上可用的资源？）
  • 直接资源：通过 resources/list 端点以以下格式公开资源：

{
  uri: string;  // 资源的唯一标识符
  name: string; // 人类可读的资源名称
  description?: string; // 可选的资源描述
  mimeType?: string; // 可选的 MIME 类型
}

• 资源模板：通过 uritemplate 公开资源：

{
  uriTemplate: string;   // 符合 RFC 6570 标准的 URI 模板
  name: string;          // 此类型的人类可读名称
  description?: string;  // 可选的资源描述
  mimeType?: string;     // 所有匹配资源的可选 MIME 类型
}

• MCP 客户端发现可用资源后如何调用？
  • 定义资源处理程序的方法如下：
    • 使用 @mcp.resource() 装饰器定义一个接受 uri 的函数。
    • 或者使用 @mcp.resource(uri_template) 进行定义。

总结：MCP 服务器通过直接提供资源 URI 或使用模板来实现资源发现。MCP 客户端 发现可用资源后，可通过相应的 URI 访问资源。

2. 💬 提示定义

提供符合特定目的的提示，为 LLM 交互提供标准化方法。用户可以明确选择提示。

需要实现的 API：

• 提示发现
  • 返回值：(名称, 描述, 参数)
• 提示使用
  • 参数：(名称, 提示中声明的参数)
  • 返回值：提示（动态的，基于资源的提示，支持多个）

3. 🖼️ 图像返回

MCP 具备返回图像的功能。

注意：可以利用 MCP 提供的各种功能和 API 构建工作流，为 LLM 分析和处理数据创造环境。