The official CLI to get started with Smithery.

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

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>

Set the project name as the first argument:

npx create-smithery my-awesome-mcp

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

Specify which package manager to use for installing dependencies:

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

Defaults to npm if not specified.

Initialize a ChatGPT app instead of a standard MCP:

npx create-smithery --gpt

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

To work on this package locally:

1. Clone the repository
2. Run bun install to install dependencies
3. Run bun run build to build the project
4. To test your local changes, run bun run start
5. To run the test suite, run bun run test