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
