MCP CLI Toolkit

MCP CLI Toolkit scaffolds a fully working MCP server in seconds — with TypeScript or JavaScript, built-in tools, resources, and dev commands. Think of it as CRA, but for MCP servers.

Quick Start

``bash
npx mcp-scaffold create my-server
`

Features

- Instant Setup - Get a working MCP server in seconds
- Built-in Examples - Pre-configured tools and resources
- Hot Reload - Development mode with auto-restart
- TypeScript & JavaScript - Choose your preferred language
- Best Practices - Production-ready project structure
- Clean Architecture - Well-organized, maintainable code

Installation

$3

`bash
npm install -g mcp-scaffold
`

Then use:

`bash
mcp create my-server
`

$3

`bash
npx mcp-scaffold create my-server
`

Usage

$3

`bash
mcp create
`

$3

`bash
mcp create my-server
`

$3

`bash


TypeScript template

mcp create my-server --template typescript

JavaScript template

mcp create my-server --template javascript

Skip prompts

mcp create my-server --yes
`

What's Included

Every generated project includes:

- ✅ Example Tools: echo and get_time implementations
- ✅ Example Resources: Server configuration endpoint
- ✅ Development Server: Hot reload with file watching
- ✅ Build Scripts: TypeScript compilation (when applicable)
- ✅ Documentation: Comprehensive README with examples
- ✅ Type Safety: Full TypeScript support (optional)

Templates

$3

- Full type safety with strict mode
- Hot reload with tsx
- Automatic compilation
- Source maps for debugging

$3

- Modern ES modules
- Node 18+ native watch mode
- Zero build step
- Faster iteration

Project Structure

Generated projects follow this structure:

TypeScript:

`
my-server/
├── src/
│ └── index.ts # Main server file (TypeScript)
├── package.json
├── tsconfig.json # TypeScript only
├── .gitignore
└── README.md
`

JavaScript:

`
my-server/
├── index.js # Main server file (JavaScript)
├── package.json
├── .gitignore
└── README.md
`

Requirements

- Node.js >= 18.0.0
- npm >= 9.0.0

Development

`bash


Clone the repo

git clone https://github.com/romeoscript/MCP_CLI.git
cd MCP_CLI

Install dependencies

pnpm install

Build

pnpm run build

Link for local testing

pnpm link

Test the CLI

mcp create test-project
``

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT