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

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

Global Installation

npm install -g mcp-scaffold

Then use:

mcp create my-server

NPX (No Installation)

npx mcp-scaffold create my-server

Usage

Interactive Mode

mcp create

Quick Create

mcp create my-server

With Options

# 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

TypeScript (Recommended)

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

JavaScript

• 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

# 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