mcp-server-quickstart

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).