气象数据服务

一个通过国家气象局API提供气象信息的MCP服务器,支持按州获取天气警报、按地理坐标获取天气预报,并提供TypeScript接口以提高可维护性。

  • by julienlucas
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 julienlucas/mcp-server-client-demo

使用说明

Weather MCP Server

Un serveur MCP (Model Context Protocol) qui fournit des informations météorologiques via l'API National Weather Service (NWS).

Fonctionnalités

  • Récupération des alertes météorologiques par état
  • Prévisions météorologiques par coordonnées géographiques
  • Support des formats GeoJSON
  • Interface TypeScript pour une meilleure maintenabilité

Prérequis

  • Node.js (v16 ou supérieur)
  • npm ou yarn
  • TypeScript
  • ts-node (pour l'exécution en développement)

Installation

  1. Clonez le dépôt :
git clone [URL_DU_REPO]
cd weather
  1. Installez les dépendances :
npm install
  1. Compilez le projet :
npm run build

Configuration

Le serveur est configuré pour se connecter à l'API NWS. Aucune configuration supplémentaire n'est nécessaire.

Utilisation

Le serveur expose deux outils principaux :

  1. get-alerts : Récupère les alertes météorologiques pour un état

    • Paramètre : state (code à deux lettres, ex: "CA", "NY")
  2. get-forecast : Récupère les prévisions météorologiques pour une localisation

    • Paramètres :
      • latitude (nombre entre -90 et 90)
      • longitude (nombre entre -180 et 180)

Structure du Projet

weather/
├── src/
│   ├── interfaces/     # Définitions des types TypeScript
│   │   └── weather.ts  # Interfaces pour les données météo
│   └── index.ts        # Point d'entrée du serveur
├── build/              # Fichiers compilés
└── package.json        # Configuration du projet

Développement

Pour lancer le serveur en mode développement :

npm run dev

Pour compiler le projet :

npm run build

Licence

MIT