天气查询工具

MCP Clima 是一个可编程行为模型,提供全球城市天气信息查询服务,支持多语言和详细气象数据展示。

  • by prodriguezr
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 prodriguezr/mcp_weather-server

使用说明

MCP Clima

Este es un MCP (Modelo de Comportamiento Programado) que proporciona información sobre el clima de diferentes ciudades.

Características

  • Obtiene el clima actual de cualquier ciudad
  • Soporte para múltiples idiomas (español e inglés)
  • Sugerencias de ciudades similares cuando no se encuentra la ciudad exacta
  • Información detallada del clima:
    • Temperatura
    • Precipitación
    • Velocidad del viento
    • Estado del clima
    • Hora actual en la ciudad

Estructura del Proyecto

src/
├── config/
│   ├── constants.ts    # Constantes y configuraciones
│   └── translations.ts # Traducciones
├── tools/
│   └── weather.ts      # Herramienta de clima
├── types/
│   └── index.ts        # Definiciones de tipos
├── utils/
│   ├── i18n.ts         # Utilidades de internacionalización
│   └── weather.ts      # Utilidades de clima
└── index.ts            # Punto de entrada

Uso

import { tools, handleRequest } from './index';

// Ejemplo de solicitud
const request = {
  tool_calls: [
    {
      name: 'get_weather',
      parameters: {
        city: 'Madrid',
      },
    },
  ],
  language: 'es', // opcional, por defecto es 'es'
};

const response = await handleRequest(request);
console.log(response.content);

API

Herramientas Disponibles

get_weather

Obtiene el clima actual de una ciudad.

Parámetros:

  • city: Nombre de la ciudad (requerido)

Respuestas

La respuesta incluye:

  • content: Mensaje con la información del clima
  • tool_calls: Array vacío (no se requieren más llamadas)

Desarrollo

  1. Clona el repositorio
  2. Instala las dependencias: npm install
  3. Ejecuta los tests: npm test
  4. Construye el proyecto: npm run build

Licencia

MIT