Skip to main content
Glama
Weather MCP Server

Weather MCP Server

by akaramanapp

天気MCPサーバー

米国国立気象局(NWS)APIを使用して、米国各地の気象情報と警報を提供するモデルコンテキストプロトコル(MCP)サーバーです。このサーバーは、モデルコンテキストプロトコルを介してAIエージェントが使用できるように設計されています。

特徴

  • 米国のどの州の天気警報も受信できるツール

  • 座標を使用して米国の任意の場所の詳細な天気予報を取得するためのツール

  • 気温、風の状況、短い予報の説明をサポート

  • 国立気象局からのリアルタイムデータ

Related MCP server: Weather MCP Server

前提条件

  • Node.js (v16 以上)

  • npm または yarn パッケージマネージャー

インストール

  1. リポジトリをクローンします。

git clone https://github.com/akaramanapp/weather-mcp-server.git
cd weather-mcp-server
  1. 依存関係をインストールします:

npm install
  1. アプリケーションをビルドします。

npm run build

MCPツール

サーバーは、AI エージェントが使用できる 2 つの MCP ツールを提供します。

アラートを取得する

特定の米国の州の天気警報を取得します。

パラメータ:

  • state : 2文字の州コード(例:CA、NY)

応答例:

{
  "content": [
    {
      "type": "text",
      "text": "Active alerts for CA: ..."
    }
  ]
}

予測を取得する

座標を使用して特定の場所の天気予報を取得します。

パラメータ:

  • latitude : 場所の緯度 (-90 ~ 90)

  • longitude : 場所の経度 (-180 ~ 180)

応答例:

{
  "content": [
    {
      "type": "text",
      "text": "Morning: Temperature: 72°F, Wind: 5mph NW, Partly cloudy..."
    }
  ]
}

プロジェクト構造

weather/
├── src/
│   └── index.ts    # Main server code with MCP tool implementations
├── build/          # Compiled JavaScript files
├── package.json    # Project dependencies and scripts
└── tsconfig.json   # TypeScript configuration

技術的な詳細

  • TypeScriptで構築

  • モデルコンテキストプロトコル(MCP)サーバーを実装します

  • MCP サーバーの実装には @modelcontextprotocol/sdk を使用します

  • 国立気象局 (NWS) API とのインターフェース

  • Node16モジュール解決によるES2022ターゲット

発達

サーバーを変更または拡張するには:

  1. src/index.tsファイルに変更を加える

  2. アプリケーションを再構築します。

npm run build

依存関係

  • @modelcontextprotocol/sdk: MCP サーバー実装フレームワーク

  • zod: ツールパラメータのランタイム型チェックと検証

  • TypeScript: 型安全性のための開発依存性

ライセンス

ISC

注記

  • このサーバーは国立気象サービスAPIを使用しているため、米国の場所でのみ機能します。

  • APIリクエストはレート制限があり、User-Agentヘッダーが必要です。

  • すべての座標は10進度形式で入力する必要があります

  • これはスタンドアロンのCLIアプリケーションではなく、モデルコンテキストプロトコルを通じてAIエージェントにツールを提供するサーバーです。

Available Tools

2 tools
get-alertsC

Get weather alerts for a state

Inputs: state (required).

get-forecastC

Get weather forecast for a location

Inputs: latitude (required), longitude (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: get-alerts retrieves weather alerts for a state, while get-forecast provides weather forecasts for a location. There is no overlap in functionality, and an agent can easily differentiate between them based on their specific use cases.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun naming pattern with hyphens (get-alerts and get-forecast). This uniformity makes the tool set predictable and easy to understand, with no deviations in style or convention.

    Tool Count2/5

    With only two tools, the server feels thin for a weather domain, as it lacks essential operations like getting current conditions, historical data, or radar information. While the tools are well-defined, the count is too low to provide comprehensive coverage for typical weather-related tasks.

    Completeness2/5

    The tool set is severely incomplete for a weather server, missing core functionalities such as current weather, historical data, and radar or satellite imagery. Agents will face significant gaps when trying to perform common weather queries, leading to potential failures in broader tasks.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides tools to fetch weather alerts for US states and forecasts based on latitude/longitude coordinates using the US National Weather Service API.
      2
      79 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI models to fetch weather alerts and detailed forecasts for US locations using the National Weather Service API.
      79 npm
      GPL 3.0