home / mcp / weather mcp server
Provides weather forecasts and alerts from the US National Weather Service with GitHub authentication for secure access.
Configuration
View docs{
"mcpServers": {
"dmitry-melnishin-mcp-weather": {
"command": "npx",
"args": [
"-y",
"@dmitry-melnishin/mcp-weather"
]
}
}
}Weather MCP Server provides weather forecasts and alerts for US locations by interfacing with the National Weather Service API. It requires GitHub authentication to access weather tools, ensuring secure, user-bound access while delivering timely forecasts and active alerts.
You use this MCP server by interacting with an MCP client to authenticate with GitHub and then request weather data. First authenticate, then fetch forecasts for a specific location or retrieve active weather alerts by state. You can run these actions from any MCP-enabled client that supports the tools exposed by this server.
Typical workflows include: getting a forecast for a given coordinate pair to plan activities, or pulling current alerts for a state to stay ahead of severe weather. Each action requires you to be authenticated with a GitHub personal access token before you can access the weather tools.
Prerequisites: Node.js version 18 or higher is recommended, along with npm or yarn as your package manager.
Install the MCP Weather server globally using npm:
npm install -g @dmitry-melnishin/mcp-weatherConfigure the MCP server in your MCP client settings to expose the weather server. You can either use the npx-based invocation or a global installation. The following settings show both options.
{
"mcpServers": {
"weather": {
"command": "npx",
"args": ["-y", "@dmitry-melnishin/mcp-weather"]
}
}
}If you installed the package globally, use this configuration instead.
{
"mcpServers": {
"weather": {
"command": "mcp-weather"
}
}
}Authentication is performed with a GitHub personal access token. You do not need to configure special GitHub permissions beyond token-based identity verification. Tokens are stored only in memory during the server session and are not logged or persisted to disk.
Usage within an MCP client is designed to be straightforward: first authenticate, then request get_forecast by latitude and longitude, or get_alerts by state code. All tool usage requires prior authentication.
Authenticate with GitHub using a personal access token to enable access to all weather tools.
Retrieve a weather forecast for a specific US location by providing latitude and longitude after authentication.
Retrieve active weather alerts for a given US state code after authentication.