# MCP Quickstart

> MCP Quickstart is an open-source MCP server for agent tooling. Quickstart TypeScript MCP weather server for learning MCP deployment over stdio. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/achsaf6/mcp-quickstart
- **MCP Registry name:** io.github.achsaf6/mcp-quickstart
- **Categories:** [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

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

## Alternatives

- [Sampledotnetmcpserver](https://ai-powered.com/mcp/sampledotnetmcpserver): Sampledotnetmcpserver is an open-source MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/mcp-quickstart
