Ambient Weather MCP

@NanaGyamfiPrempeh30

About Ambient Weather MCP

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

#weather #iot #home-automation #api-integration #python #docker #stdio

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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>"
      }
    }
  }
}

Tools

health check confirming the server is running and keys are configured

lists all weather stations on your account with their latest readings

full weather report for a specific station, by MAC address

Overview

What is Ambient Weather MCP?

Ambient Weather MCP is a Model Context Protocol server that connects AI assistants to personal Ambient Weather stations. It allows users to ask natural‑language questions about their weather data instead of parsing raw API JSON.

How to use Ambient Weather MCP?

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.

Key features of Ambient Weather MCP

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

Use cases of Ambient Weather MCP

Query your personal weather station’s current conditions using natural language
Check the health and configuration of the MCP server
List all registered stations and their latest sensor data in one call
Integrate real‑time weather readings into an AI‑powered assistant or chat interface

FAQ from Ambient Weather MCP

What API keys do I need?

You need an Application Key and an API Key, both generated from your account at dashboard.ambientweather.net/account.

How do I run the server?

Use the Docker command with the required environment variables (AMBIENT_API_KEY and AMBIENT_APP_KEY) and the -i flag. The image is yawgyamfiprem32/ambient-weather-mcp:latest.

Is the server secure?

Yes. It runs as a non‑root user, stores no secrets inside the image, and credentials are passed via environment variables. Secrets are never logged, and each commit is scanned with TruffleHog.

What tools are available?

Three tools: ping (health check), get_devices (list all stations), and get_current_weather (full report for a specific station by MAC address).

Where can I get help or report issues?

The source code repository is at github.com/NanaGyamfiPrempeh30/ambient-weather-mcp. This is the primary place for documentation and issue tracking.

Frequently asked questions

What API keys do I need?

You need an Application Key and an API Key, both generated from your account at dashboard.ambientweather.net/account.

How do I run the server?

Use the Docker command with the required environment variables (`AMBIENT_API_KEY` and `AMBIENT_APP_KEY`) and the `-i` flag. The image is `yawgyamfiprem32/ambient-weather-mcp:latest`.

Is the server secure?

Yes. It runs as a non‑root user, stores no secrets inside the image, and credentials are passed via environment variables. Secrets are never logged, and each commit is scanned with TruffleHog.

What tools are available?

Three tools: `ping` (health check), `get_devices` (list all stations), and `get_current_weather` (full report for a specific station by MAC address).

Where can I get help or report issues?

The source code repository is at github.com/NanaGyamfiPrempeh30/ambient-weather-mcp. This is the primary place for documentation and issue tracking.

Comments

Basic information

More Media & Design MCP servers

Spotify MCP Server

marcelmarais

Lightweight MCP server for Spotify

384

yt-dlp-mcp

kevinwatt

A Model Context Protocol (MCP) server that bridges Video & Audio content with Large Language Models using yt-dlp.

257

MCP Figma to React Converter

StudentOfJS

MCP server for converting Figma designs to React components

MCP Google Map Server

cablate

A powerful Model Context Protocol (MCP) server providing comprehensive Google Maps API integration with LLM processing capabilities.

374

YouTube Transcript Server

kimtaeyoon83

This is an MCP server that allows you to directly download transcripts of YouTube videos.

572