weather-MCP-server

OseasSon/weather-MCP-server

3.1

If you are the rightful owner of 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.

The Weather MCP Server for Intercom is a custom Model Context Protocol server that integrates weather tools with Intercom, providing real-time weather data and personalized customer interactions.

Tools
3
Resources
0
Prompts
0

Weather MCP Server for Intercom

Custom Model Context Protocol (MCP) server that integrates weather tools with Intercom.

🎯 What This Is

This project demonstrates how to build a custom MCP server that integrates with Intercom. Use it as a template for:

  • Learning MCP development with real-world examples
  • Building your own tools by replacing weather APIs with your data sources
  • Product demos showing MCP capabilities

🚀 Quick Start

  1. Read the setup guide:
  2. Start the server: uv run weather.py

🛠️ What It Provides

Weather Tools for Intercom Fin

  • greet - Personalized customer greetings
  • get_alerts - Real-time weather alerts for US states
  • get_forecast - Detailed weather forecasts by coordinates

Technical Features

  • Real-time data from National Weather Service API
  • HTTP transport via ngrok tunneling
  • Async operations for optimal performance
  • Error handling with graceful fallbacks

📋 Files Overview

  • weather.py - Main MCP server implementation
  • SETUP_GUIDE.md - Complete setup instructions for team
  • pyproject.toml - Python project configuration

⚠️ Important Note

Due to MCP SDK bug #423, you may need to apply a simple patch to enable tool discovery. This bug may be fixed in future SDK releases. Full instructions in the setup guide.

🔧 Tech Stack

  • FastMCP - MCP server framework
  • Python 3.11+ - Runtime environment
  • httpx - HTTP client for weather API
  • ngrok - HTTP tunneling

📚 Learn More

Created by: Oséas Filho