MCP Weather Service Server

🚀 🌦️ 天氣服務 MCP 服務器

本項目實現了一個簡單的筆記保存系統，支持使用自定義的 note:// URI 方案訪問單個筆記，還提供了筆記摘要生成和添加筆記等實用功能。同時，詳細介紹了安裝、開發、構建發佈及調試等方面的內容，方便開發者進行項目的使用和拓展。

🚀 快速開始

📥 安裝

Claude Desktop

• MacOS：配置文件路徑為 ~/Library/Application\ 支持/Claude/claude_desktop_config.json
• Windows：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json

✨ 主要特性

📚 資源

此服務器實現了一個簡單的筆記保存系統：

• 使用自定義的 note:// URI 方案訪問單個筆記。
• 每個筆記資源包含名稱、描述和 text/plain MIME 類型。

💡 提示語句

該服務器提供一個單一的提示：

• summarize-notes：生成所有當前筆記的摘要。
  • 使用可選的 "style" 參數控制詳細程度（簡短/詳細）。
  • 結合所有當前筆記和樣式設置生成提示語句。

🛠️ 工具

該服務器實現了一個工具：

• add-note：向服務器添加新的筆記。
  • 接收必需字符串參數 "name" 和 "content"。
  • 更新服務器狀態並通知客戶端資源更改。

📦 安裝指南

📥 安裝

Claude Desktop

• MacOS：配置文件路徑為 ~/Library/Application\ 支持/Claude/claude_desktop_config.json
• Windows：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json

🔧 技術細節

🏗️ 構建與發佈

準備將包進行分發：

1. 同步依賴並更新鎖定文件：

uv sync

2. 構建包的發行版：

uv build

這將在 dist/ 目錄中創建源和_wheel 發行版。 3. 發佈到 PyPI：

uv publish

注意：PyPI 的認證信息可通過環境變量或命令行標誌設置：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或者用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

🔍 調試

MCP 服務器通過標準輸入輸出運行，因此調試可能較為困難。為了獲得最佳的調試體驗，強烈推薦使用 MCP Inspector。 使用 npm，可通過以下命令啟動 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory C:\Prj\weather_service run weather-service

啟動時，Inspector 會顯示可在瀏覽器訪問的 URL，從而開始調試。