Scan to contactarticle
README
🚀 🌦️ 天气服务 MCP 服务器
本项目实现了一个简单的笔记保存系统，支持使用自定义的 note:// URI 方案访问单个笔记，还提供了笔记摘要生成和添加笔记等实用功能。同时，详细介绍了安装、开发、构建发布及调试等方面的内容，方便开发者进行项目的使用和拓展。
🚀 快速开始
📥 安装
Claude Desktop
- MacOS：配置文件路径为
~/Library/Application\ 支持/Claude/claude_desktop_config.json - Windows：配置文件路径为
%APPDATA%/Claude/claude_desktop_config.json
开发/未公开服务器配置
``` "mcpServers": { "weather_service": { "command": "uv", "args": [ "--directory", "C:\Prj\weather_service", "run", "weather_service" ] } } ```公开服务器配置
``` "mcpServers": { "weather_service": { "command": "uvx", "args": [ "weather_service" ] } } ```✨ 主要特性
📚 资源
此服务器实现了一个简单的笔记保存系统：
- 使用自定义的
note://URI 方案访问单个笔记。 - 每个笔记资源包含名称、描述和
text/plainMIME 类型。
💡 提示语句
该服务器提供一个单一的提示：
summarize-notes：生成所有当前笔记的摘要。- 使用可选的 "style" 参数控制详细程度（简短/详细）。
- 结合所有当前笔记和样式设置生成提示语句。
🛠️ 工具
该服务器实现了一个工具：
add-note：向服务器添加新的笔记。- 接收必需字符串参数 "name" 和 "content"。
- 更新服务器状态并通知客户端资源更改。
📦 安装指南
📥 安装
Claude Desktop
- MacOS：配置文件路径为
~/Library/Application\ 支持/Claude/claude_desktop_config.json - Windows：配置文件路径为
%APPDATA%/Claude/claude_desktop_config.json
开发/未公开服务器配置
``` "mcpServers": { "weather_service": { "command": "uv", "args": [ "--directory", "C:\Prj\weather_service", "run", "weather_service" ] } } ```公开服务器配置
``` "mcpServers": { "weather_service": { "command": "uvx", "args": [ "weather_service" ] } } ```🔧 技术细节
🏗️ 构建与发布
准备将包进行分发：
- 同步依赖并更新锁定文件：
uv sync
- 构建包的发行版：
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，从而开始调试。