Skip to content
MCP server

MCP Quickstart

Quickstart TypeScript MCP weather server for learning MCP deployment over stdio

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
1.0.2
Listing updated
today

Similar MCP servers

About MCP Quickstart

MCP Quickstart is an open-source MCP server for agent tooling. It runs locally on your machine and is started by your AI client.

The README describes this as a simple weather server written in TypeScript, built as a starting point that follows the Model Context Protocol quickstart tutorial. It runs over stdio and is published to npm under the package name @achsaf/quickstart-test.

The registry entry lists one required secret, an API key for the underlying service, which clients must supply through environment variables. The registry description is brief and no hosted version or remote endpoint is listed.

It suits developers who want a minimal, readable example of wiring an MCP server into an AI client before building their own tools.

Install

Run in a terminal

claude mcp add mcp-quickstart --env SECRET='<SECRET>' -- npx -y @achsaf/quickstart-test

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "@achsaf/quickstart-test"
      ],
      "env": {
        "SECRET": "<SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "@achsaf/quickstart-test"
      ],
      "env": {
        "SECRET": "<SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-quickstart": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@achsaf/quickstart-test"
      ],
      "env": {
        "SECRET": "<SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "@achsaf/quickstart-test"
      ],
      "env": {
        "SECRET": "<SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "@achsaf/quickstart-test"
      ],
      "env": {
        "SECRET": "<SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SECRETYour API key for the serviceRequired

What it does

Stdio transport
Runs as a local process that communicates with MCP clients over standard input and output.
TypeScript codebase
Implemented in TypeScript as a compact reference for structuring an MCP server.
npm package distribution
Published to npm so it can be launched from client configuration without cloning the repository.
Required API key setting
Declares a secret environment variable that must be provided before the server runs.

Good for

  • Learning how to structure a basic MCP server in TypeScript
  • Testing an MCP client connection over stdio
  • Using a weather lookup as a template for a custom tool server

Pricing

Open source

Open source; no paid plan stated.

MCP Quickstart FAQ

What transport does it use?

The registry entry lists stdio as the only transport.

Does it need credentials?

Yes, the registry entry marks an API key environment variable named SECRET as required.

Is MCP Quickstart free?

Yes. MCP Quickstart is open source, so you can use and self-host it for free.

How do I add MCP Quickstart to Claude Code?

Run this command in your terminal: claude mcp add mcp-quickstart --env SECRET='<SECRET>' -- npx -y @achsaf/quickstart-test

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers