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 分析和處理數據創造環境。