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，从而开始调试。