Servidor MCP de Clima

Un servidor MCP de consulta meteorológica basado en FastMCP, que proporciona el clima actual, pronósticos futuros, conversión de grados Celsius/Fahrenheit, recursos de ciudades populares y prompts de consejos de viaje.

El proyecto incluye dos puntos de entrada para la ejecución:

• server.py: modo stdio local, adecuado para clientes MCP locales como Claude Desktop, Cursor, Cherry Studio, etc.

• server_remote.py: modo HTTP Streamable, adecuado para despliegue en plataformas de alojamiento remoto como ModelScope.

Funcionalidades

• get_weather(city: str): consulta el clima actual de una ciudad específica.

• get_forecast(city: str, days: int = 3): consulta el pronóstico del tiempo para una ciudad específica, por defecto 3 días.

• temperature_convert(value: float, from_unit: str): conversión entre grados Celsius y Fahrenheit.

• weather://cities: devuelve un recurso con una lista de ciudades comunes.

• travel_advisor(destination: str, date: str): genera un prompt de asesoramiento meteorológico para viajes.

Los datos meteorológicos provienen de wttr.in, sin necesidad de tokens de API adicionales.

Requisitos del entorno

• Python >= 3.12

• Se recomienda usar uv para gestionar las dependencias.

Instalación de dependencias

uv sync

Si no utiliza uv, también puede instalar las dependencias en un entorno virtual:

pip install "mcp[cli]>=1.27.0" "httpx>=0.28.1"

Ejecución local

Modo stdio:

uv run python server.py

Ejemplo de configuración del cliente MCP:

{
  "mcpServers": {
    "weather-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"]
    }
  }
}

Ejecución remota

Modo HTTP Streamable:

uv run python server_remote.py

Escucha predeterminada:

http://0.0.0.0:8000/mcp/

Ejemplo de configuración del cliente MCP remoto:

{
  "mcpServers": {
    "weather-server": {
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

Instrucciones de despliegue en ModelScope

Al crear o desplegar un servidor MCP en ModelScope, puede completar la dirección del repositorio de GitHub de este proyecto y utilizar el archivo de entrada remoto:

python server_remote.py

El servicio se iniciará en modo HTTP Streamable, escuchando en 0.0.0.0:8000, y el endpoint de MCP será:

/mcp/

Si la plataforma admite comandos de inicio personalizados, se recomienda usar:

uv run python server_remote.py

O usarlo después de instalar las dependencias previamente en el entorno de la plataforma:

python server_remote.py

Estructura del proyecto

.
├── README.md
├── pyproject.toml
├── server.py
├── server_remote.py
└── uv.lock

Licencia

Si necesita realizar una publicación de código abierto, por favor añada el archivo de Licencia según corresponda.