create-smithery

create-smithery

The official CLI to get started with Smithery.

This package helps you set up a new Smithery project for building MCPs.

Usage

To create a new Smithery project, run:

npx create-smithery@latest

Or with bun:

bunx create-smithery@latest

You will be prompted to configure your project interactively.

Alternatively, specify the project name directly:

npx create-smithery <project-name>

or

bunx create-smithery <project-name>

Options

Project Name

Set the project name as the first argument:

npx create-smithery my-awesome-mcp

Transport Type

Choose how your MCP will communicate. Use the -t or --transport flag:

npx create-smithery --transport http
npx create-smithery --transport stdio

• HTTP: Runs on a server (remotely accessible)
• STDIO: Runs on the user's machine (when you need filesystem access)

If not specified, you'll be prompted to choose (defaults to HTTP).

Package Manager

Specify which package manager to use for installing dependencies:

npx create-smithery --package-manager npm
npx create-smithery --package-manager bun

Defaults to npm if not specified.

Combined Example

npx create-smithery --transport stdio --package-manager bun

Development

To work on this package locally:

• Clone the repository
• Run bun install to install dependencies
• Run bun run build to build the project
• To test your local changes, run bun run start
• To run the test suite, run bun run test