MCP天气服务服务器

🌦️ weather_service MCP 服务器

🧩 组件

📚 资源

此服务器实现了一个简单的笔记保存系统：

• 通过自定义的 note:// URI 模式访问各个笔记
• 每个笔记资源都有名称、描述以及 text/plain 的 MIME 类型

💡 提示

服务器提供了一个提示功能：

• summarize-notes：创建所有已保存笔记的摘要
  • 可以通过可选的 "style" 参数控制详细程度（brief/detailed）
  • 根据当前所有的笔记及其样式设置生成提示

🛠️ 工具

服务器实现了以下工具：

• add-note：向服务器添加新的笔记
  • 接收必需的字符串参数 "name" 和 "content"
  • 更新服务器状态，并将资源更改通知客户端

🚀 快速开始

📥 安装

Claude Desktop

对于 MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
对于 Windows: %APPDATA%/Claude/claude_desktop_config.json

👨‍💻 开发

🏗️ 构建与发布

要为分发准备软件包：

1. 同步依赖并更新锁定文件：

uv sync

1. 构建软件包的分发版本：

uv build

这将在 dist/ 目录下创建源码和轮子的分发版本。

1. 发布到 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，从而开始调试。