MCP Weather
A weather Model context protocol (MCP) tool server to allow AI agents to have access to real time weather data.
Overview
MCP Weather is a weather information service built with the Model Control Protocol (MCP) framework that provides access to real-time weather data from the National Weather Service (NWS).
To use MCP Weather, clone the repository, install the dependencies, and run the service using Python. You can then access weather alerts and forecasts through the provided API.
- Retrieve active weather alerts by US state code - Get detailed weather forecasts for specific locations - Clean, formatted output for easy reading - Built as an MCP tool for seamless integration with AI assistants
- Providing real-time weather updates to AI assistants
- Alerting users about severe weather conditions in their area
- Offering detailed weather forecasts for planning outdoor activities
Add to your AI client
Use these steps to connect MCP Weather in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-weather-jpan8866": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-weather-jpan8866"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-weather-jpan8866": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-weather-jpan8866"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-weather-jpan8866": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-weather-jpan8866"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-weather-jpan8866": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-weather-jpan8866"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-weather-jpan8866": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-weather-jpan8866"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-weather-jpan8866": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-weather-jpan8866"
]
}
}
}FAQ
Can MCP Weather provide weather data for all US states?
Yes! MCP Weather can retrieve weather alerts and forecasts for any US state.
What are the requirements to run MCP Weather?
You need Python 3.13 or higher and the specified dependencies.
How can I contribute to MCP Weather?
Contributions are welcome! You can submit a Pull Request on the GitHub repository.