Weather MCP Server

Weather MCP Server

site icon
2025.04.30 0
Python天气服务警报系统位置服务
Weather MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,专门用于提供美国各州的天气警报。该项目使用 MCP Python SDK 构建,展示了如何创建一个带有工具、资源和 Docker 集成的 MCP 服务器。
View on GitHub

Overview

基本能力

产品定位

Weather MCP Server 是一个专注于提供美国各州天气警报的服务,适用于需要实时天气信息的应用场景。

核心功能

  • 使用国家气象服务 API 提供美国各州的天气警报
  • 支持 stdio 和 SSE (Server-Sent Events) 传输
  • Docker 容器化支持
  • 与 Claude Desktop 和 Cursor IDE 集成
  • 使用 Groq 的 LLM 驱动的 CLI 客户端
  • 内置对话记忆支持

适用场景

  • 需要实时天气警报的应用
  • 与 Claude Desktop 或 Cursor IDE 集成的开发环境
  • 使用 Docker 容器化部署的服务

工具列表

  • get_alerts: 获取美国各州的天气警报
  • 参数: state (两字母的美国州代码,如 CA, TX, NY)
  • 示例: result = await session.call_tool("get_alerts", arguments={"state": "CA"})

常见问题解答

  • 如何安装服务器?
  • 本地安装: pip install -r mcpserver/requirements.txt
  • Docker 安装: docker pull ksharma9719/weather-mcp-serverdocker build -t weather-mcp-server .
  • 如何运行服务器?
  • 本地开发: cd server 然后 python weather.py
  • Docker: docker run -p 8000:8000 ksharma9719/weather-mcp-server

使用教程

使用依赖

  • Python 3.11 或更高版本
  • uv 包管理器
  • Docker (可选)

安装教程

  1. 克隆仓库:
git clone <repository-url>
cd Creating-MCP-server
  1. 安装依赖:
pip install -r mcpserver/requirements.txt

调试方式

  1. 运行服务器:
cd server
python weather.py
  1. 使用 CLI 客户端:
cd server
python client.py
  1. 使用标准 I/O 客户端:
cd mcpserver
python client-stdio.py
  1. 使用 SSE 客户端:
cd mcpserver
python client-sse.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。