Weather MCP

🌤️ Said MCP - Real-time Weather Service

Said MCP is a simple yet powerful implementation of an MCP (Model Context Protocol) server. It's designed to provide real-time weather information through an accessible and extensible tool.

🚀 Quick Start

Said MCP offers a straightforward way to get real-time weather data. Just follow the steps in the usage example to start using it.

✨ Features

• 🔧 Custom MCP Server with @modelcontextprotocol/sdk
• 📍 Precise Geolocation via the Open-Meteo API
• 🌡️ Current Weather Data: temperature, rain, and precipitation
• ⚡ Simple and Efficient Interface based on stdio transport

🧠 How It Works

The server exposes a tool called obtener-clima, which allows you to query the weather status for any city. It resolves the location using geographical coordinates and fetches up-to-date weather data.

🔍 Execution Flow

1. 🏙️ Receive the name of a city.
2. 🌍 Get its latitude and longitude through the Open-Meteo geocoding API.
3. ☁️ Query the current weather data.
4. 📝 Return the information in a structured format.

📦 Project Structure

.
├── .gitignore
├── main.ts              # Main file of the MCP server
├── package.json         # Project dependencies and metadata
├── package-lock.json    # Dependency version control
└── README.md            # This file 📝

🛠️ Requirements

• NodeJS >= 18
• TypeScript
• Internet access (for API calls)

💻 Usage Examples

Basic Usage

server.tool(
  'obtener-clima',
  'Herramienta para obtener el clima en tiempo real',
  { city: z.string().describe('City name') },
  async ({ city }) => {
    // Consulta a la API y retorno de datos...
  }
)

Advanced Usage

const transport = new StdioServerTransport()
await server.connect(transport)

🔌 Integration

The server connects using StdioServerTransport, enabling easy integration with MCP-compatible systems.

📄 License

MIT License

✨ Author

Passionately developed by Said Ruiz.