MCP Weather Server

Un servidor Model Context Protocol (MCP) que ofereix pronòstics meteorològics horaris i diaris utilitzant l’API AccuWeather.

Inici ràpid

Necessiteu una clau d’API AccuWeather (nivell gratuït disponible).
Registreu-vos aquí i creeu una aplicació per obtenir la vostra clau.

Exporteu la clau d’API com a variable d’entorn:

export ACCUWEATHER_API_KEY=your_api_key_here

Després executeu el servidor MCP Weather directament amb:

npx -y @timlukahorstmann/mcp-weather

O, per accedir via HTTP/REST amb supergateway:

npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" \
  --port 4004 \
  --baseUrl http://127.0.0.1:4004 \
  --ssePath /messages \
  --messagePath /message \
  --cors "*" \
  --env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"

Exemple de configuració del servidor MCP

Per integrar amb Claude Desktop o altres clients compatibles amb MCP, afegiu això a la vostra configuració (p. ex. claude_desktop_config.json):

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@timlukahorstmann/mcp-weather"],
      "env": {
        "ACCUWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Visió general

Aquest servidor MCP permet que models de llenguatge gran (com Claude) accenguin dades meteorològiques en temps real. Quan es integra amb un LLM, habilita el model per a:

• Obtenir pronòstics meteorològics precisos i actualitzats
• Proporcionar dades meteorològiques horàries per als pròxims 12 hores
• Accedir a pronòstics meteorològics diaris fins a 15 dies
• Mostrar dades tant en unitats métriques (°C) com imperials (°F)
• Veure temperatura, condicions, informació de precipitació i altres detalls meteorològics

Eines disponibles

Pronòstic meteorològic horari

• Nom de l’eina: weather-get_hourly
• Proporciona pronòstics horaris per als pròxims 12 hores
• Paràmetres:
  • location (obligatori): Nom de la ciutat o localització
  • units (opcional): "metric" (Celsius, per defecte) o "imperial" (Fahrenheit)

Pronòstic meteorològic diari

• Nom de l’eina: weather-get_daily
• Proporciona pronòstics diaris fins a 15 dies
• Paràmetres:
  • location (obligatori): Nom de la ciutat o localització
  • days (opcional): Nombre de dies de pronòstic (1, 5, 10 o 15; per defecte és 5)
  • units (opcional): "metric" (Celsius, per defecte) o "imperial" (Fahrenheit)

Requisits previs

• Node.js ≥18
• Una clau d’API AccuWeather (configurada via .env o el vostre shell)

Instal·lació

1. Clonau aquest repositori:

   git clone https://github.com/TimLukaHorstmann/mcp-weather.git
   cd mcp-weather
   

2. Instal·leu les dependències:

   npm install
   

3. Obteniu una clau d’API AccuWeather:

   • Registreu-vos a AccuWeather API
   • Creeu una nova aplicació i obtéreu una clau d’API

4. Creeu un fitxer .env amb la vostra clau d’API:

   ACCUWEATHER_API_KEY=your_api_key_here
   

5. Construïu el projecte:

   npm run build
   

Ús amb Claude Desktop

1. Configureu Claude Desktop per utilitzar aquest servidor MCP:

   • Obriu Claude Desktop
   • Voleu a Settings > Developer > Edit Config
   • Afegiu el següent a la vostra claude_desktop_config.json:

   {
     "mcpServers": {
       "weather": {
         "command": "npx",
         "args": ["-y", "@timlukahorstmann/mcp-weather"],
         "env": {
           "ACCUWEATHER_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

2. Reinicieu Claude Desktop

3. En una conversa nova, habiliteu el servidor MCP fent clic a la icona del connector i seleccionant "weather"

4. Ara podeu preguntar a Claude pels pronòstics meteorològics, com per exemple:

   • "Quin és el pronòstic meteorològic horari per a la ciutat de New York?"
   • "Dóna'm el pronòstic de 5 dies per a Londres."
   • "Com serà el temps a Tòquio aquesta setmana en Fahrenheit?"
   • "Plourà a San Francisco demà?"

Desenvolupament

• Instal·leu les dependències de desenvolupament: npm install
• Revisar el codi: npm run lint
• Construir: npm run build
• Executar proves: npm test
• Iniciar en mode desenvolupament: npm run dev

Contribució

Les contribucions són benvingudes! Si us plau, envieu una Pull Request.

Millores futures

Estem sempre buscant millorar el servidor MCP Weather. Aquí hi ha algunes funcionalitats que considerem per a futures versions:

• Pronòstics horaris ampliats: Més enllà de 12 hores, per exemple 24 o 48 hores.
• Alertes meteorològiques: Integració amb l’API d’avisos meteorològics severos d’AccuWeather.
• Autocompletar localització: Millora de la cerca de localitzacions amb suggeriments d’autocompletar.
• Dades meteorològiques històriques: Accés a condicions meteorològiques passades.

Si teniu idees per a altres característiques, obriu un problema!

Canvi de versions

0.4.0

• S'ha eliminat la necessitat de sessionId en totes les eines ja que no s’utilitzava internament
• Això simplifica les integracions i redueix la confusió per a l’ús amb LLM

0.3.0 i versions anteriors

• Llançaments inicials amb funcionalitat bàsica

llicència

Aquest projecte està llicenciat sota la Llicència MIT - consulteu el fitxer LICENSE per a detalls.