Ambient Weather MCP

by NanaGyamfiPrempeh30

359 downloads
Not rated
GitHub

About

An MCP server that connects AI assistants to Ambient Weather personal weather stations. Built with Python FastMCP. Exposes three tools: ping (health check), get_devices (lists all stations on your account with latest readings), and get_current_weather (full weather report for a s

Details

Author
NanaGyamfiPrempeh30
Downloads
359
Categories
Media

- Health‑check endpoint (ping) to confirm server and key configuration
- List all stations on your account with latest readings (get_devices)
- Retrieve full weather report for a specific station by MAC address (get_current_weather)
- Runs as a non‑root user with no embedded secrets
- Credentials provided only via environment variables and never logged
- TruffleHog scans every commit and push for security

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Ambient Weather MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Run the server via Docker with your Ambient API Key and Application Key set as environment variables: docker run -i --rm -e AMBIENT_API_KEY="..." -e AMBIENT_APP_KEY="..." yawgyamfiprem32/ambient-weather-mcp:latest. The -i flag is required because stdio MCP servers exit immediately on EOF without it. After startup, three tools are available: ping, get_devices, and get_current_weather.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ambient weather mcp": {
            "ambient-weather": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "-e",
                    "AMBIENT_API_KEY",
                    "-e",
                    "AMBIENT_APP_KEY",
                    "yawgyamfiprem32/ambient-weather-mcp:latest"
                ],
                "env": {
                    "AMBIENT_API_KEY": "<YOUR_API_KEY>",
                    "AMBIENT_APP_KEY": "<YOUR_APP_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "ambient-weather": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "AMBIENT_API_KEY",
            "-e",
            "AMBIENT_APP_KEY",
            "yawgyamfiprem32/ambient-weather-mcp:latest"
        ],
        "env": {
            "AMBIENT_API_KEY": "<YOUR_API_KEY>",
            "AMBIENT_APP_KEY": "<YOUR_APP_KEY>"
        }
    }
}

Ambient Weather MCP Server

Connect AI assistants to your Ambient Weather personal weather station. Ask natural-language questions instead of parsing raw API JSON.

Tools

- ping — health check confirming the server is running and keys are configured - get_devices — lists all weather stations on your account with their latest readings - get_current_weather — full weather report for a specific station, by MAC address

Quick start

docker run -i --rm -e AMBIENT_API_KEY="..." -e AMBIENT_APP_KEY="..." yawgyamfiprem32/ambient-weather-mcp:latest The -i flag is required. Stdio MCP servers exit immediately on EOF without it.

Get API keys

Generate both an Application Key and an API Key at dashboard.ambientweather.net/account.

Security

Runs as a non-root user. No embedded secrets. Credentials are provided via environment variables and never logged. TruffleHog scans every commit and push.

Source

github.com/NanaGyamfiPrempeh30/ambient-weather-mcp — MIT licensed.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.