setup-mcp-server

Scaffold a new Model Context Protocol (MCP) server in seconds. Think of it as create-react-app but for MCP servers.

It downloads the mcp-typescript template and sets it up locally with your project name - ready to build on.

Note: The template uses Fastify as the HTTP framework and TypeScript for type-safe development.

Features

• One-command project scaffolding
• Downloads the latest template directly from GitHub
• Automatically sets your project name in package.json
• No dependencies installed automatically - you stay in control
• Colorful CLI output with progress spinners
• Refuses to overwrite non-empty directories

Prerequisites

• Node.js 22+
• npm

Installation

You can use it directly with npx:

npx setup-mcp-server my-awesome-server

or install globally using npm:

npm install -g setup-mcp-server

Usage

Basic

setup-mcp-server my-awesome-server

If no project name is provided, it defaults to my-mcp-server:

setup-mcp-server

Output

setup-mcp-server - scaffold an MCP server in seconds

✔ Template downloaded
✔ Template extracted
✔ Project scaffolded

Done! Your MCP server is ready.

  cd my-awesome-server
  npm install
  cp sample.env .env
  npm run build
  npm start

CLI Options

Usage: setup-mcp-server [options] [project-name]

Scaffold a new MCP server from the mcp-typescript template

Arguments:
  project-name  Name of the project directory (default: "my-mcp-server")

Options:
  -V, --version  output the version number
  -h, --help     display help for command

What You Get

The scaffolded project includes:

• MCP SDK integration with tool registration and SSE transport
• Fastify HTTP server with environment-based logging
• TypeScript compilation and ESLint configuration
• Docker support with a production-ready Dockerfile
• Example tool implementation to get you started
• Test setup with tap

How It Works

1. Downloads the main branch tarball from karankraina/mcp-typescript
2. Extracts it into a new directory named after your project
3. Updates package.json with your project name and resets the version to 0.1.0

Running Tests

This project uses the native Node.js test runner:

npm test

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Feel free to reach out if you have any questions or need further assistance.

Happy coding!