Weather
Example MCP weather server exposing forecast and alert tools, for learning MCP
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.1
- Listing updated
- today
Similar MCP servers
About Weather
Weather is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.
The README presents this as a companion example for the official Model Context Protocol tutorial on building a server. It is a deliberately minimal weather server that exposes two tools, a forecast lookup and an alerts lookup, backed by the US National Weather Service API.
The repository holds parallel implementations in Python, TypeScript, Go, Rust and Ruby, all communicating over stdio. Each language also has a matching chatbot client that launches a server and lets an LLM call its tools, and the README notes that clients and servers can be mixed across languages.
It suits developers who want a small, readable reference for wiring tools into an MCP client rather than a production weather service. The README itself warns that the code is intentionally minimal and needs added authentication and hardening before it is exposed over a network.
Install
Run in a terminal
claude mcp add weather --env YOUR_API_KEY='<YOUR_API_KEY>' -- npx -y @dingw1982/mcp-quickstart-tsAdd to claude_desktop_config.json
{
"mcpServers": {
"weather": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"weather": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"weather": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"weather": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"weather": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
YOUR_API_KEYYour API key for the serviceRequired
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- get_forecast
- Returns weather forecast data.
- get_alerts
- Returns active weather alerts.
What it does
- Forecast tool
- Returns weather forecast data through a tool named get_forecast (get-forecast in TypeScript).
- Alerts tool
- Returns active weather alerts through a tool named get_alerts (get-alerts in TypeScript).
- Multi-language servers
- Equivalent weather servers are provided in Python, TypeScript, Go, Rust and Ruby.
- Matching chatbot clients
- Companion clients launch a server, list its tools and run an interactive chat loop.
- Stdio transport
- All servers communicate over standard input and output.
Good for
- Learning how to build a basic MCP server with tools
- Comparing MCP server implementations across several programming languages
- Testing MCP client wiring without API credentials
- Using as a starting template for a custom tool server
Pricing
Open source
Open-source example code in the MCP quickstart repository.
Weather FAQ
Which transport do the servers use?
All servers communicate over stdio.
Do I need credentials to try the clients?
The README says the example clients need an ANTHROPIC_API_KEY to run the chat loop. Without a key, each client still connects and lists the server's tools before exiting.
Is this production-ready?
No. The README describes the examples as intentionally minimal and says network-exposed servers need authentication and basic hardening.
Is Weather free?
Yes. Weather is open source, so you can use and self-host it for free.
How do I add Weather to Claude Code?
Run this command in your terminal: claude mcp add weather --env YOUR_API_KEY='<YOUR_API_KEY>' -- npx -y @dingw1982/mcp-quickstart-ts
What are the best alternatives to Weather?
The closest alternatives to Weather are Weather, Weather, Weather, Weather Alerts & Forecast and Weather.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.