JUHE API Marketplace
itsPatH avatar
MCP Server

Basic MCP Weather Tool

A simple educational MCP server implemented in Node.js that allows users to fetch weather information for cities using the Open-Meteo API.

1
GitHub Stars
8/23/2025
Last Updated
No Configuration
Please check the documentation below.

README Documentation

🛠️ Basic MCP Demo - Weather Tool

Este proyecto es un ejemplo básico de un servidor MCP (Model Context Protocol) implementado en Node.js. Define una herramienta simple para consultar información del clima de una ciudad utilizando la API pública de Open-Meteo.

📦 Características

  • Servidor MCP compatible utilizando @modelcontextprotocol/sdk.
  • Herramienta fetch-weather que permite consultar el clima de una ciudad.
  • Ejemplo educativo, ideal para entender el flujo básico de MCP.
  • Sin claves API privadas, solo usa servicios públicos gratuitos.

🚀 Requisitos

  • Node.js (v18 o superior recomendado)
  • Acceso a Internet para consultar las APIs públicas

⚙️ Instalación

  1. Clona el repositorio:

    git clone https://github.com/itsPatH/basicMCP.git
    cd basicMCP
    
  2. Instala las dependencias:

npm install
  1. Ejecuta el servidor MCP:
npx ts-node main.ts   

Nota: Este servidor espera ser utilizado por un cliente MCP compatible (como Claude con soporte MCP habilitado). Si no tienes un cliente MCP, el servidor quedará esperando conexión.

🌐 Alternativa para Pruebas Locales (Opcional)

Puedes extender este proyecto para agregar un servidor HTTP local y probar la herramienta sin un cliente MCP. Ejemplo de esto disponible en la rama local-test.

⚠️ Advertencias

⚡ Este proyecto es solo para fines educativos. ⚡ No está pensado para entornos de producción. ⚡ Si amplías el proyecto, no subas archivos con claves privadas o información sensible.

📄 Licencia

Este proyecto está bajo la licencia MIT. Eres libre de usarlo, modificarlo o distribuirlo para aprendizaje.

✨ Créditos

Quick Actions

Key Features

Model Context Protocol
Secure Communication
Real-time Updates
Open Source