create-mcp-ts !NPM Version

Create a new MCP server in TypeScript, batteries included.

Getting started

npm init mcp-ts your-server
cd your-server
npm run dev

`create-mcp-ts` requires zero build configuration - it will automatically install everything you need to develop, build, and set up your MCP server.

Set up your MCP server in Cursor, Windsurf, and Claude Desktop

`create-mcp-ts` can automatically configure your MCP server in Cursor, Windsurf, and Claude Desktop:

npm run setup

This script checks if `your-server` already exists in each client's respective MCP configuration file. If not, it adds an entry pointing to the server script (`dist/index.js`):

{
  "mcpConfig": {
    "your-server": {
      "command": "node",
      "args": ["/path/to/your-server/dist/index.js"]
    }
  }
}

For more details on how to set up MCP servers in Cursor, Windsurf, and Claude Desktop, see:

• MCP docs for Cursor
• MCP docs for Windsurf
• MCP docs for Claude Desktop

Custom templates

If you'd like to use a custom template, you can do so by passing the template npm package name or file path to the `npx create-mcp-ts` command:

npx create-mcp-ts your-server --template=mcp-ts-template-default
npx create-mcp-ts your-server --template=file:/path/to/mcp-ts-template

Publishing your MCP server

If you plan to share your MCP server, you can publish it to npm:

1. Set `"version"` in `package.json` and ensure `"private"` is set to `false`.

2. Run `npm install`.

3. Run `npm run build`.

4. Run `npm login` (if needed).

5. Run `npm publish`.

Ejecting from `mcp-scripts`

The `mcp-scripts` package contains build tools for `create-mcp-ts` projects - everything you'll need to develop, build, and set up an MCP server without any additional configuration.

Under the hood `mcp-scripts` uses tsup and esbuild, lightweight, battle-tested utilities that are well-suited for production-grade TypeScript projects.

If you'd like to eject from `mcp-scripts`, run the following command:

npm run eject

This will remove the `mcp-scripts` dependency and replace any related commands from your project's `package.json` file.

Troubleshooting your MCP server

Confirm you have Node.js installed

If you experience issues running your MCP server, the first thing to check is that you have Node.js installed globally. You can check this by running:

node --version

If you don't have Node.js installed, you can install it by following the instructions here.

Usage with Node.js version managers

Some MCP client environments may not have access to the full system PATH, which can cause issues when using Node.js version managers like `nodenv` or `nvm`. In these cases, you'll need to specify the full path to the Node.js binary in your MCP config:

{
  "mcpConfig": {
    "your-server": {
      "command": "/absolute/path/to/node",
      "args": ["/path/to/your-mcp-server/dist/index.js"]
    }
  }
}

To find the absolute path to your Node.js binary, you can run:

which node

Make sure to update your MCP config in each client (Cursor, Windsurf, or Claude Desktop) with the correct absolute path to the Node.js binary you want to use.

For any other issues, please open an issue here.

Philosophy

`create-mcp-ts` is designed to be a batteries-included, "it just works" experience for MCP server developers.

• Batteries included: there is only one build dependency, `mcp-scripts`. It uses tsup, esbuild, and other amazing open source projects, but provides a curated experience on top of them.
• Zero configuration: you don't need to configure anything. A reasonably good configuration is handled for you so you can focus on writing code.
• No lock-in: you can "eject" to a custom setup at any time. Run a single command, and all the configuration and build dependencies will be moved directly into your project, so you can pick up right where you left off.

This project is inspired by create-react-app.

Related packages

• **packages/mcp-scripts**: The build tools that power `create-mcp-ts` projects.
• **packages/mcp-ts-template-default**: Default project template for `create-mcp-ts`.