Weather MCP Server

What is Weather MCP Server?

Weather MCP Server is a Model Context Protocol (MCP) server built with Bun that provides a collection of weather reporting tools for LLMs like Claude. It supports current weather and hourly/daily forecasts based on a zip code, demonstrating how to set up a basic MCP server that can handle tool requests and execute them in a structured way.

How to use Weather MCP Server?

Install Bun and Claude Desktop, clone the repository, run bun install to install dependencies, then run bun run build to bundle the server. Edit Claude Desktop’s claude_desktop_config.json to point to the built build/main.js, set the required environment variables (APP_NAME and APP_EMAIL), restart Claude Desktop, and enable the server from the “Search and Tools” menu.

Key features of Weather MCP Server

• Supports current weather and hourly/daily forecasts by zip code.
• Multiple tools work in tandem, orchestrated by the LLM.
• Easily extensible: new tools extend AbstractTool and implement ITool.
• Automatically registers new tools upon restart — no additional configuration.
• Built with Bun for fast execution and bundling.
• Includes test coverage framework using lcov and Bun.

Use cases of Weather MCP Server

• Ask “current weather for 90210” and get live results.
• Ask “what's the weather this weekend?” – Claude prompts for a zip code.
• Claude reuses previous tool results to answer follow-up questions.
• Developers can add custom weather‑related tools (e.g., air quality, UV index).

FAQ from Weather MCP Server

What weather tools does the server provide?

It provides tools to retrieve current weather and future forecasts (hourly and daily) given a U.S. zip code.

What are the runtime requirements?

You need to have Bun installed and Claude Desktop configured to run the bundled server.

How do I add a new tool?

Create a new module in ./src/tools that extends AbstractTool and implements ITool, then implement the required methods. The new tool is automatically registered upon restart.

How is the server configured for Claude Desktop?

Edit claude_desktop_config.json with the command "bun", arguments ["run", "<path>/build/main.js"], and environment variables APP_NAME and APP_EMAIL.

Does the server need an API key for weather data?

The README only specifies setting APP_NAME and APP_EMAIL in the config; no separate weather API key is mentioned for the production build.