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!