Sunwood Ai Labs MCP Weather Service Server

🚀 🌦️ 天氣服務 MCP 服務器

本項目的天氣服務 MCP 服務器實現了簡單的筆記保存系統，提供了特定的提示語句和工具，方便用戶進行筆記管理和操作。

🚀 快速開始

📥 安裝

Claude Desktop

不同系統下的配置文件位置如下：

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

✨ 主要特性

📚 資源

此服務器實現了簡單的筆記保存系統，具備以下特點：

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

💡 提示語句

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

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

🛠️ 工具

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

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

👨‍💻 開發

🏗️ 構建與發佈

要準備分發包，可按以下步驟操作：

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

uv sync

2. 構建發行版：

uv build

這將在 dist/ 目錄中生成源和輪文件的發行版。 3. 發佈到 PyPI：

uv publish

注意：PyPI 的認證信息需通過環境變量或命令行參數設置：

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

🔍 調試

由於 MCP 服務器通過標準輸入輸出執行，調試可能較為困難。為獲得最佳調試體驗，強烈推薦使用 MCP 檢查器。

使用 npm 可以運行以下命令啟動 MCP 檢查器：

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

啟動時，檢查器會在瀏覽器中顯示一個可訪問的 URL，開始調試。