mcp-getgather/mcp-openweathermap

api-weather-mcp

Basic HTTP MCP server for a weather app using the OpenWeatherMap API. Containerized for convenience.

Quickstart

Connecting Your MCP Client to a Deployed Instance

For convenience, we have deployed the container using fly.io at https://mcp-openweathermap.fly.dev/mcp.

If you so desire, you can connect your MCP client directly to this instance. Clients like Claude offer an option to add custom connectors directly from the settings. Open Claude, navigate to settings, and go to the "Connectors" tab. Click on "Add custom connector" and give your connector a name. Then, in the second box for "Remore MCP server URL" you can paste https://mcp-openweathermap.fly.dev/mcp. Finish by clicking "Add" (no advanced settings necessary for this!). You should see the new weather MCP appear in your list of connectors. Open a new chat in Claude and look for the server under the "Tools" icon. You should see it appear under the name you set for it.

For clients that don't use custom connectors in the UI, you can always set up the weather MCP using a simple URL in the configuration JSON. For example, in Cursor/VS Code you can add the following to your mcp.json:

{
  "mcpServers": {
    "weather": {
      "url": "https://mcp-openweathermap.fly.dev/mcp"
    }
  }
}

Run Locally with Docker

Alternatively, you can build the Docker image locally and add the running endpoint to your client config. The following command pulls and runs the latest public image for the weather MCP.

$ docker run -p 8000:8000 -e OPEN_WEATHER_API_KEY={api_key} ghcr.io/mcp-getgather/api-weather-mcp

When running the docker command locally be sure to include an OPEN_WEATHER_API_KEY as an environment variable argument, otherwise the service will fail. You can get a free API key here. The deployed instance on Fly already has an API key, which is why it works out of the box.

Then add http://localhost:8000/mcp as a model endpoint in your MCP client. If using Claude Desktop, you can add the following to your claude_desktop_config.json (which is found from Claude -> Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "http-weather": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://127.0.0.1:8000/mcp",
        "--allow-http"
      ]
    }
  }
}

For VS Code or Cursor:

{
  "mcpServers": {
    "weather": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

If you're not using Claude, and you're client supports http streaming directly, you will just need the local URL and /mcp extension as in the VS Code/Cursor example above.

Remember for streamable http (including mcp-remote), you need your mcp server to be running (as opposed to the client launching it for you as with stdio).