Overview
What is mcp-server-quickstart?
mcp-server-quickstart is an example MCP server that retrieves weather information for the United States using the National Weather Service (NWS) API. It is designed as a hands‑on implementation for the Zenn article “MCPサーバー自作入門” (Getting Started with Building Your Own MCP Server) and is intended for developers learning to create MCP servers.
How to use mcp-server-quickstart?
Install dependencies with npm install, then build the server with npm run build. To use it in Cursor, add the following configuration to .cursor/mcp.json:
{
"mcpServers": {
"weather-forecast": {
"command": "node",
"args": ["./build/index.js"]
}
}
}
Key features of mcp-server-quickstart
- Fetches weather forecasts by latitude/longitude
- Uses the official National Weather Service API
- Supports locations only within the United States
- Simple installation and build process with npm
- Ready‑to‑use Cursor integration via
.cursor/mcp.json - Licensed under ISC
Use cases of mcp-server-quickstart
- Learning how to build a custom MCP server step‑by‑step
- Retrieving current weather forecasts for U.S. coordinates programmatically
- Integrating weather data into an MCP‑compatible client like Cursor
FAQ from mcp-server-quickstart
How do I set up mcp-server-quickstart in Cursor?
Add the server configuration block shown above to your .cursor/mcp.json file, pointing to the built ./build/index.js script.
What API does mcp-server-quickstart use?
It uses the National Weather Service (NWS) API to obtain weather forecasts.
Does mcp-server-quickstart support locations outside the United States?
No, only locations within the United States are supported.
What are the prerequisites to run mcp-server-quickstart?
Node.js and npm are required. After cloning, run npm install then npm run build before starting the server.
How do I build the server from source?
Run npm install to install dependencies, then npm run build to compile the TypeScript code into JavaScript (output goes to ./build/index.js).
