smart-weather-mcp-server

lis186/smart-weather-mcp-server

3.2

If you are the rightful owner of smart-weather-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Smart Weather MCP Server is a cloud-based intelligent weather query service designed for serverless environments, leveraging the Model Context Protocol (MCP) to provide global weather information through natural language queries.

Tools
3
Resources
0
Prompts
0

Smart Weather MCP Server

🌤️ AI-powered weather queries for Claude Desktop and MCP clients

STDIO zh smoke

What it does

Query weather in natural language through Claude Desktop or any MCP client. Supports Chinese, Japanese, and English.

🟢 Production Ready - Live at https://smart-weather-mcp-server-891745610397.asia-east1.run.app

Quick Start

Claude Desktop (Recommended)

npm install && npm run build

Add to your Claude Desktop config:

{
  "mcpServers": {
    "smart-weather": {
      "command": "node",
      "args": ["/path/to/dist/unified-server.js", "--mode=stdio"]
    }
  }
}

Cloud Service

Use the hosted version via mcp-remote:

{
  "smart-weather-cloud": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://smart-weather-mcp-server-891745610397.asia-east1.run.app/mcp"]
  }
}

Features

  • Natural language queries: "台北今天天氣" or "London weather tomorrow"
  • Multi-language support: Chinese, Japanese, English
  • Real weather data: Google Weather API integration
  • Smart caching: 5min weather, 30min forecasts, 7-day locations
  • Dual deployment: Local (STDIO) or Cloud (Streamable HTTP)

Available Tools

search_weather

Query current weather, forecasts, or historical data for any location.

find_location

Resolve ambiguous location names and get precise coordinates.

get_weather_advice

Get personalized recommendations based on weather conditions.

Development

# Install and build
npm install && npm run build

# Run tests
npm test

# Local development
npm run dev              # STDIO mode
npm run dev:http         # HTTP mode on port 8080

# Production
npm start                # Auto-detect mode

Local STDIO smoke tests (Chinese)

  • One-shot English baseline: npm run test:stdio-smoke
  • Chinese samples (Taipei/Okinawa): npm run test:stdio-zh
  • CI will run the Chinese STDIO smoke on PR and main if secrets exist:
    • WEATHER_API_KEY, GOOGLE_MAPS_API_KEY
    • Gemini is disabled in CI (GEMINI_DISABLED=true) to validate rule/hybrid paths only

Deployment

Google Cloud Run

# Setup (one-time)
./scripts/setup-gcp-ci.sh
./scripts/setup-secrets.sh

# Deploy
./scripts/deploy-cloudrun.sh

Auto-deploys on push to main branch.

Docker

npm run docker:build
npm run docker:run

API Endpoints

  • /health - Health check
  • /mcp - MCP client connections
  • / - Service info

Architecture

Built with TypeScript, Express.js, and Google Cloud Platform. Uses hybrid rule-based + AI parsing for optimal performance.

Documentation

License

MIT