Ambient Weather MCP

Name: Ambient Weather MCP
Author: NanaGyamfiPrempeh30

@NanaGyamfiPrempeh30

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

基本情報

カテゴリ

メディアとデザイン

トランスポート

stdio

公開者

NanaGyamfiPrempeh30

投稿者

Nana Gyamfi Prempeh

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

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

概要

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.