MCP Weather and Hello

Provides hello and weather data tools via MCP with local stdio servers.

python

1

GitHub Stars

python

Language

5 months ago

First Indexed

2 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": {
    "markandersonix-mcp-gemini-cli-base": {
      "command": "conda",
      "args": [
        "run",
        "-n",
        "mcp",
        "fastmcp",
        "dev",
        "mcp_hello.py:mcp"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You run lightweight MCP servers locally to expose tooling and data through a simple, consistent interface. This guide shows how to start two Python-based MCP servers, run them with the MCP client, and access the provided tools to get greetings and current weather data.

How to use

Start the two MCP servers using the commands below. Once running, you can use an MCP client to interact with each server’s tools. The hello server exposes a greeting tool, while the weather server provides a get_current_weather tool that fetches current weather data using your API key.

How to install

Prerequisites you need before running the servers:

Python 3.12 or compatible
Conda (optional but used in examples)
uv package manager (installed via its installer)

Install and run the two MCP servers with these concrete steps. Each step is a separate command so you can copy-paste them one by one.

Run the two MCP servers and use their tools

{
  "mcpServers": {
    "hello": {
      "type": "stdio",
      "command": "conda",
      "args": ["run", "-n", "mcp", "fastmcp", "dev", "mcp_hello.py:mcp"]
    },
    "weather": {
      "type": "stdio",
      "command": "conda",
      "args": ["run", "-n", "mcp", "fastmcp", "dev", "mcp_weather.py:mcp"],
      "env": {
        "OPENWEATHER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Environment and API keys

The weather server requires an API key for OpenWeatherMap. Set OPENWEATHER_API_KEY to your API key in the environment or in the provided .env file for local startup. Use the value exactly as issued by the weather service.

Tools and usage notes

The hello server exposes a hello_world tool that returns a greeting when you provide your name. The weather server exposes a get_current_weather tool that returns current weather data for a location using your API key. Use your MCP client to select a server and run the corresponding tool with the required parameters.

Troubleshooting and tips

If a server fails to start, verify that the specified Python environment and dependencies are available. Ensure the command and arguments match exactly as shown. For weather data, confirm that OPENWEATHER_API_KEY is set. If you change the project path, update the working directory in your MCP client configuration accordingly.

Available tools

hello_world

A tool that greets you by name by returning a personalized hello message.

get_current_weather

Fetches the current weather data for a specified location using the weather server.