Weather MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Weather MCP Server what are the weather alerts for California?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server Creation and MCP client connection (Agent-Claude,cursor or, custom server calling and integration with local LLMs).
This project demonstrates how to create and connect an MCP (Model Context Protocol) weather server using FastMCP.
š Want to learn more about MCP? Check out our Comprehensive MCP Guide for detailed explanations, concepts, and best practices.
Prerequisites
Python 3.13+
uvpackage manager installed
Related MCP server: Example MCP Server
Setup Instructions
1. Initialize the Project
Initialize a new project using uv:
uv init2. Create Virtual Environment
Create a virtual environment for the project:
uv venv3. Activate Virtual Environment
Activate the virtual environment:
Windows:
.venv\Scripts\activateLinux/Mac:
source .venv/bin/activate4. Install MCP CLI
Add the MCP CLI package to enable fast MCP CLI commands:
uv add "mcp[cli]"Running the MCP Server
Development Mode
To run the MCP server in development mode:
uv run mcp dev server/weather.pyExpected Output:
Starting MCP inspector...
āļø Proxy server listening on localhost:6277Connecting to Claude Desktop
Install Server to Claude
Add the weather server to Claude Desktop:
uv run mcp install server/weather.pyExpected Output:
Added server 'weather' to Claude config
Successfully installed weather in Claude appOnce installed, you can ask Claude questions like:
"What are the weather alerts in CA?"
The MCP server will be called automatically and display the results.
Manual Configuration for Cursor or Other Clients
For Cursor or other clients, you'll need to manually configure the server using the Claude Desktop config file format.
Get the server configuration from: claude_desktop_config file
Example Configuration:
"weather": {
"command": "C:\\Users\\gaura\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\uv.EXE",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"C:\\Users\\gaura\\OneDrive\\Desktop\\AI projects\\mcp_project\\server\\weather.py"
]
}Note: Update the paths in the configuration to match your system paths.
Usage in Cursor:
Go to MCP ā mcp config.json
Add the configuration above
Using MCP with Local LLMs (mcp-use)
mcp-use allows you to connect to MCP servers directly without an AI agent for programmatic tool access. This is useful for custom server calling and integration with local LLMs.
Installation
Install the mcp-use package:
uv add mcp-useConfiguration
Create a file named weather.json and add the following configuration to connect local LLMs to the MCP server:
{
"mcpServers": {
"weather": {
"command": "C:\\Users\\gaura\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\uv.EXE",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"C:\\Users\\gaura\\OneDrive\\Desktop\\AI projects\\mcp_project\\server\\weather.py"
]
}
}
}Note: Update the paths in the configuration to match your system paths.
References
FastMCP: https://github.com/jlowin/fastmcp
Create MCP servers and connect them to different clients like Claude, Cursor, etc.
mcp-use: https://github.com/mcp-use/mcp-use
Connect to MCP servers directly without an AI agent for programmatic tool access (custom server calling and use)
Available Tools
1 toolget_alertsA
Get weather alerts for a US state.
Args: state: Two-letter US state code (e.g. CA, NY)
Inputs: state (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it to. The tool's purpose is clearly defined and distinct by default.
Since there is only one tool, it inherently follows a consistent pattern with itself. The naming uses a verb_noun format (get_alerts), which is clear and standard, and there are no other tools to introduce inconsistency.
A single tool is too few for a weather server, as it severely limits functionality. For a weather domain, agents would expect basic operations like getting current conditions, forecasts, or historical data, but this server only provides alerts for US states, making it incomplete and under-scoped.
The tool set is severely incomplete for a weather server. It only covers weather alerts for US states, missing core weather functionalities such as current weather, forecasts, or data for other regions. This creates significant gaps that will likely cause agent failures when broader weather queries are made.
Related MCP Connectors
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
An MCP server for weather information by @kulybaba
An MCP server for weather information by @kulybaba
MCP server for weather with reasoning ā umbrella advice, outdoor checks, city comparisons.
Related MCP Servers
- FlicenseBqualityDmaintenanceA simple demonstration server for the MCP Python SDK that provides weather alerts for locations, allowing users to query weather information through Claude Desktop or Cursor.1-
- FlicenseBqualityDmaintenanceA demonstration MCP (Model Control Protocol) server built with FastMCP framework that allows integration with Claude Desktop, Cursor, and Claude Code IDEs.5-
- FlicenseBqualityDmaintenanceA basic MCP server adapted from the official quickstart guide that provides weather data functionality and works with OpenAI chat completions API. Demonstrates MCP server setup with configuration examples for Claude Desktop and development tools.2-
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server built with the mcp-framework to provide weather-related tools and data to AI clients. It enables integration of weather capabilities and custom tools into the MCP ecosystem for use with platforms like Claude Desktop.13 npm-