Llamada de herramientas meteorológicas con Cline y MCP

Un pequeño servidor MCP en Python que permite a un LLM obtener datos meteorológicos reales.

El usuario hace una pregunta meteorológica en Cline. El LLM decide si llamar a una herramienta meteorológica, genera los argumentos necesarios y envía la solicitud a este servidor. El servidor obtiene datos del US National Weather Service (NWS) y luego el LLM usa el resultado para escribir la respuesta final.

Cómo funciona

User question
    -> Cline sends the question and tool definitions to the LLM
    -> The LLM selects a weather tool and generates its arguments
    -> Cline calls the Python MCP server
    -> The server fetches real data from api.weather.gov
    -> The LLM turns the tool result into a natural-language answer

Related MCP server: Weather MCP Server

Stack tecnológico

• Python 3.10

• MCP Python SDK

• Cline como cliente MCP y host del LLM

• OpenRouter con un modelo DeepSeek para la demo

• HTTPX

• US National Weather Service API

• uv

Herramientas

get_forecast

Obtiene los próximos cinco períodos de pronóstico para una ubicación de EE. UU.

{
  "latitude": 40.7128,
  "longitude": -74.006
}

get_alerts

Obtiene alertas meteorológicas activas para un estado de EE. UU.

{
  "state": "NY"
}

Configuración

Requisitos:

• Python 3.10

• uv

• Visual Studio Code con Cline

• Una clave de API para un LLM con capacidad de usar herramientas, configurada en Cline

Instala el proyecto:

git clone <https://github.com/yang648557392/weather-mcp-tool-calling.git>
cd weather
uv sync

Añade el servidor MCP a la configuración de MCP de Cline. Reemplaza la ruta con la ruta absoluta para este proyecto:

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/weather", "run", "weather.py"],
      "disabled": false
    }
  }
}

Reinicia el servidor MCP en Cline. Cline debería detectar get_forecast y get_alerts automáticamente.

Si Cline no encuentra uv, reemplaza "uv" por la ruta absoluta devuelta por:

which uv

Uso

Pregunta a Cline algo como:

What will the weather be like in New York tomorrow?
Are there any active weather alerts in California?

Cline mostrará la herramienta seleccionada, sus argumentos, el resultado de la herramienta y la respuesta final del LLM.

Limitaciones

• La API de NWS solo cubre ubicaciones atendidas por el servicio meteorológico de Estados Unidos.

• El LLM es responsable de convertir un nombre de ubicación en coordenadas.

• Cline es necesario como host del LLM y cliente de MCP.

• Las claves de API de los proveedores se almacenan en Cline y no deben incluirse en este repositorio.

Autor

Mingzhe Yang