MCP cover image
See in Github
2025-03-08

MCP的天气服务器应用程序

1

Github Watches

1

Github Forks

0

Github Stars

MCP Weather Server

A weather server application built with the Model Context Protocol (MCP) that provides access to real-time weather data and alerts.

Overview

MCP Weather Server is a TypeScript application that serves as a backend for weather-related applications using the MCP SDK. It provides tools for accessing current weather conditions, forecasts, and weather alerts through the National Weather Service (NWS) API.

Features

  • US Weather Forecasts: Get detailed forecast data for any US location via latitude/longitude
  • Weather Alerts: Retrieve active weather alerts for any US state
  • MCP Integration: Built as an MCP server for seamless AI assistant integration
  • Command-line Interface: Easy to install and run as a CLI tool

Architecture

The application is built using the Model Context Protocol (MCP) framework:

  1. MCP Server Layer: Handles communication with MCP clients
  2. Weather Tools: Implements forecast and alert functionality
  3. External API Integration: Connects to the National Weather Service (NWS) API

Component Structure

The server includes two primary weather tools:

  • get-forecast: Retrieves detailed weather forecasts for a location specified by latitude and longitude
  • get-alerts: Obtains active weather alerts for a specified US state

These tools communicate with the National Weather Service API to provide reliable weather data.

Tech Stack

  • Node.js
  • TypeScript
  • MCP SDK (@modelcontextprotocol/sdk)
  • National Weather Service API
  • Zod (for input validation)

Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/cskiro/MCP-Weather-Server.git

# Navigate to the project directory
cd MCP-Weather-Server

# Install dependencies
npm install

# Build the project
npm run build

# Make the CLI executable
chmod +x build/index.js

# Install globally (optional)
npm install -g .

Usage

You can use the server in two ways:

  1. Direct invocation:
weather
  1. Through an MCP-compatible client/assistant: Configure your MCP client to use the weather tool for forecasts and weather alerts.

API Usage

Get Weather Forecast

// Example: Get forecast for San Francisco
{
  latitude: 37.7749,
  longitude: -122.4194
}

Get Weather Alerts

// Example: Get alerts for California
{
  state: "CA"
}

Data Sources

This server uses the National Weather Service API, which provides official weather data for the United States. Due to the limitations of this data source, the application currently only supports US-based locations.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the ISC License - see the LICENSE file for details.

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Alexandru Strujac
  • Efficient thumbnail creator for YouTube videos

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • 发现市场上最全面,最新的MCP服务器集合。该存储库充当集中式枢纽,提供了广泛的开源和专有MCP服务器目录,并提供功能,文档链接和贡献者。

  • ShrimpingIt
  • MCP系列GPIO Expander的基于Micropython I2C的操作,源自ADAFRUIT_MCP230XX

  • OffchainLabs
  • 进行以太坊的实施

  • modelcontextprotocol
  • 模型上下文协议服务器

  • huahuayu
  • 统一的API网关,用于将多个Etherscan样区块链Explorer API与对AI助手的模型上下文协议(MCP)支持。

  • Mintplex-Labs
  • 带有内置抹布,AI代理,无代理构建器,MCP兼容性等的多合一桌面和Docker AI应用程序。

    Reviews

    5 (1)
    Avatar
    user_IEEzcF2j
    2025-04-17

    As an avid user of MCP-Weather-Server, I can confidently say that this service is incredibly reliable and user-friendly. Developed by cskiro, it offers precise weather forecasts and seamless integration, making it an essential tool for anyone needing accurate weather data. Highly recommended for developers and weather enthusiasts alike. Check it out on GitHub and experience the efficiency it brings to your projects!