天气笔记服务器

一个基于Python的MCP服务器,提供实时天气查询和本地笔记存储功能,适用于个人数据管理和天气信息获取。

  • by gwyer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gwyer/MCPWeather

使用说明

MCP天气记录服务器

Python中的一个最小模型上下文协议(MCP)服务器,它公开了三个工具:

可用工具

  1. get_weather(城市) –使用Open-Meteo API返回当前天气

    • 输入:城市名称(字符串)
    • 输出:温度、风速、天气代码等。
  2. save_note(文本) –将注释保存到本地JSON文件

    • 输入:注释文本(字符串)
    • 输出:带有ID和时间戳的已保存笔记
  3. get_notes() –从本地存储中检索所有保存的笔记

    • 输入:无
    • 输出:包含ID、文本和时间戳的所有笔记的数组

设置

看 SETUP_CLAUDE.md 有关连接到Claude Desktop的说明。

测试

在没有MCP客户端的情况下运行测试套件:

source .venv/bin/activate
python test_tools.py

运行服务器

直接启动服务器(用于测试):

source .venv/bin/activate
python server.py

使用以下命令优雅地停止服务器 Ctrl+C (只需要按一下)。

有关停止服务器的更多详细信息,请参阅 停车服务.md.

特性

  • ✅ 来自Open-Meteo API的实时天气数据
  • ✅ 基于JSON的本地笔记存储
  • ✅ 检索所有已保存的笔记
  • ✅ 优雅的停机处理
  • ✅ 全面的错误处理
  • ✅ 包括完整的测试套件
  • ✅ 与Claude Desktop和Claude Code配合使用

需求

  • Python 3.11+
  • 虚拟环境(含)
  • MCP兼容客户端(克劳德桌面或克劳德代码)

贡献

欢迎投稿!请随意:

  • 报告错误
  • 建议新功能
  • 提交拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件

致谢

与 模型上下文协议 通过Anthropic。