MCPWizard CLI for Model Context Protocol Servers

Overview

MCPWizard is a Command Line Interface (CLI) tool designed to simplify the creation and deployment of Model Context Protocol (MCP) servers. It provides a streamlined workflow for initializing projects, managing tools, and generating configuration files for Claude Desktop.

Installation

To install MCPWizard globally, run the following command:

npm install -g mcpwizard

Features

• Initialize new MCP server projects: Quickly set up a new MCP server project with a chosen template.
• Add/manage tools: Easily add and manage tools for your MCP server.
• Build your MCP server: Prepare your server for deployment.
• Generate Claude Desktop configuration files: Create configuration files tailored for Claude Desktop.
• Inspect MCP servers: Analyze and inspect your MCP server setup.

Note: Currently, MCPWizard only supports tool type in the MCP protocol.

Roadmap

• Support for MCP resources: Future updates will include support for managing MCP resources.
• Support for MCP prompts: Enhancements to handle MCP prompts are planned.
• Support for MCP transport: Integration with MCP transport protocols is on the roadmap.
• Deployment service integration: Seamless deployment service integration is in development.

Usage

Initialize a New Project

mcpwizard init [name] [options]

Options:
- -t, --template <template>: Specify a template (typescript, python). Default is "typescript".

Add a Tool

mcpwizard tool add <tool-name> [options]

Options:
- -d, --description <description>: Tool description.

Generate Claude Desktop Configuration

mcpwizard generate-claude-config [options]

Options:
- -o, --output <path>: Output file path.
- -s, --servers <servers...>: Server names to include.

Build Your Server

mcpwizard build

Deploy Your Server

mcpwizard deploy

Inspect Your Server

mcpwizard inspect

Project Structure

When running mcpwizard init my-mcp-server, the user gets a new project with the selected template structure:

TypeScript Template

my-mcp-server/
├── src/
│   ├── prompts/     # MCP prompts definitions
│   ├── resources/   # MCP resources definitions
│   └── tools/       # MCP tools implementations
├── .env.template    # Environment variables template
├── package.json     # Dependencies and scripts
└── tsconfig.json    # TypeScript configuration

Python Template

my-mcp-server/
├── prompts/         # MCP prompts definitions
├── resources/       # MCP resources definitions
├── tools/           # MCP tools implementations
├── .env.template    # Environment variables template
├── requirements.txt # Python dependencies
└── server.py        # Main server file

Dependencies

• chalk: Terminal string styling.
• commander: Command-line interface.
• fs-extra: Enhanced file system methods.
• globby: Glob matching utilities.
• inquirer: Interactive command line interface.
• ora: Elegant terminal spinners.

License

MIT

Contributing

Contributions are welcome! Here's the structure of the mcpwizard package:

mcpwizard/
├── bin/              # CLI entry point
│   └── mcpwizard.js  # Main CLI file
├── src/
│   ├── commands/     # CLI command implementations
│   ├── templates/    # Project templates (typescript, python)
│   ├── utils/        # Utility functions 
│   └── validators/   # Input validation logic
├── package.json      # Package configuration
└── README.md         # This file

About

MCPWizard is a package designed to help you create and deploy MCP servers efficiently. For more information, visit mcpwizard.vercel.app.