Weather MCP Server

Name: Weather MCP Server
Author: katjes733

@katjes733

代码仓库

关于 Weather MCP Server

暂无概览

基本信息

分类

媒体与设计

许可证

MIT license

运行时

node

传输方式

stdio

发布者

katjes733

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "weather-mcp-server-katjes733": {
      "command": "bun",
      "args": [
        "run",
        "verify"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.