MCP Weather

Un servidor para obtener información meteorológica utilizando la API de OpenWeather.

Documentación

MCP Weather - Integración con Claude Desktop

Este proyecto es un servidor MCP (Model Context Protocol) de ejemplo diseñado para usarse con la aplicación Claude Desktop. Está construido para funcionar sin problemas con Claude Desktop.

Características

  • Servidor MCP basado en TypeScript
  • Consulta meteorológica mediante la API de OpenWeather
  • Integración sencilla con Claude Desktop

Estructura del Proyecto

.
├── package.json
├── tsconfig.json
├── src/
│   └── index.ts
├── claude_desktop_config.json

Instalación

Requisitos

Configuración

  1. Clona el repositorio:
    git clone <repository-url>
    cd mcp-weather
    
  2. Instala las dependencias:
    npm install
    
  3. Crea un archivo .env y complétalo de la siguiente manera:
    WEATHER_API_URL=https://api.weatherapi.com/v1/current.json
    WEATHER_API_KEY=<your_API_KEY>
    

Integración con Claude Desktop

  1. En Claude Desktop, ve a File -> Settings -> Developer -> Edit Config.

  2. Añade un bloque similar al ejemplo siguiente al archivo de configuración (edita las rutas de archivo para que coincidan con tu propio sistema):

    {
      "mcpServers": {
        "weather": {
          "command": "npx",
          "args": ["tsx", "C:/your/path/mcp-weather/src/index.ts"],
          "cwd": "C:/your/path/mcp-weather"
        }
      }
    }
    

    Nota: Reemplaza C:/your/path/ con la ruta real a tu proyecto en tu computadora.

  3. Guarda la configuración y reinicia Claude Desktop.

Archivo .env y Configuración de Rutas

En src/index.ts, la ruta al archivo .env está configurada por defecto en la raíz del proyecto:

import dotenv from "dotenv";
dotenv.config({
  // Path to your .env file. Edit as needed, e.g.: path: "C:/your/path/.env"
  path: ".env", // By default, uses the .env file in the project root
});

Si tu archivo .env está en un directorio diferente, actualiza el parámetro path en consecuencia.

Uso

Para iniciar el proyecto:

npm start

O para ejecutar el archivo principal directamente:

npx ts-node src/index.ts

Compilación

Para compilar el código TypeScript:

npm run build

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, abre issues o envía pull requests para mejoras o correcciones de errores.

Licencia

Licencia MIT