Weather

Exposes a weather tool that retrieves current conditions for a city via public APIs using MCP.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "raulcalderon-my-first-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ],
      "env": {
        "MCP_PROXY_AUTH_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

This MCP Weather Server Demo provides a lightweight tool to fetch current weather for any city using public weather APIs. It exposes a simple weather tool via the MCP protocol, so you can query weather data from any compatible MCP client and integrate it into your workflows or apps.

How to use

You connect to the weather MCP server from an MCP client and discover the available tools. The core tool you will use is fetch-weather, which accepts a city name and returns current weather information for that location. You can run the server locally and then connect your MCP client to start querying weather data.

How to install

Prerequisites you need on your machine before installing this server include Node.js and npm. Ensure you have a functional development environment for running TypeScript-based MCP servers.

# Install project dependencies
npm install

# Start the MCP server
npx tsx main.ts

Additional notes and configuration

For debugging or inspecting the MCP server through a web-based inspector, you can start the inspector alongside the server. This opens a browser-based interface that helps you configure the transport and view real-time tool results.

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts

When the inspector starts, follow the console instructions to open the provided URL and configure the session. Use the following environment setting when starting the server: MCP_PROXY_AUTH_TOKEN=YOUR_TOKEN

## What you can run and where it comes from

The server exposes a weather tool named `fetch-weather`. It uses public geocoding and weather APIs to determine location and return current conditions for the requested city.

## Important security note

If you expose this server over a network, consider securing access with a session token. The MCP proxy token shown during startup should be kept secret and used by clients to authenticate when connecting.

## Examples of MCP configurations shown in support snippets

The project includes example MCP server configurations that demonstrate how to run additional local MCP servers alongside the weather server. These examples show how to start other MCP servers using a standard stdio method.

## Available tools

### fetch-weather

Tool that takes a city name and returns current weather information using public geocoding and weather APIs.