Mcp Maker

MCP Maker

Supercharge your MCP server development with MCP Maker

[](https://www.npmjs.com/package/mcp-maker) [](https://www.npmjs.com/package/mcp-maker) [](LICENSE) [](https://nodejs.org/)

[🚀 Introduction](#-introduction) • [✨ Features](#-features) • [📥 Installation](#-installation) • [🔧 Usage](#-usage) • [🏗️ Generated MCP Structure](#%EF%B8%8F-generated-mcp-server-project-structure)

A CLI utility to quickly create and manage TypeScript MCP (Model Context Protocol) servers following a modular structure.

📋 Table of Contents

• [Introduction](#-introduction)
• [Features](#-features)
• [Installation](#-installation)
• [Usage](#-usage)
• [Create a New MCP Server](#create-a-new-mcp-server)
• [Add a Tool](#add-a-tool)
• [Add a Service](#add-a-service)
• [Add a Prompt](#add-a-prompt)
• [Add Authentication](#add-authentication)
• [Generated MCP Server Project Structure](#%EF%B8%8F-generated-mcp-server-project-structure)
• [Contributing](#-contributing)
• [License](#-license)

🚀 Introduction

mcp-maker is a command-line utility designed to streamline the process of creating and managing TypeScript MCP servers. It follows the structure and patterns used for making modular MCP servers, providing a consistent and efficient way to scaffold new projects and add components.

Whether you're creating a new MCP server from scratch or adding tools and services to an existing one, mcp-maker simplifies the process and ensures adherence to best practices.

✨ Features

• Quick Project Scaffolding: Create a fully structured MCP server project with a single command
• Automated Tool Creation: Add new tools with proper structure and automatic registration in the toolHandler
• Service Management: Add new services with proper structure and automatic registration
• Prompt Creation: Add new MCP-compatible prompts with proper structure and automatic registration
• Authentication Support: Add multiple authentication types (Basic, Token, OAuth) to your MCP server
• Consistent Structure: Ensures all projects follow the same structure and patterns
• TypeScript Support: Full TypeScript support with proper type definitions
• Interactive CLI: User-friendly command-line interface with helpful prompts
• Template-based Generation: Uses Handlebars templates for consistent code generation
• Automatic Dependency Management: Handles npm dependencies and TypeScript configuration

📥 Installation

Prerequisites

• Node.js (>= 18.19.0)
• npm (>= 7.0.0)

Global Installation (Recommended)

npm install -g mcp-maker

Local Installation

npm install --save-dev mcp-maker

🔧 Usage

Create a New MCP Server

mcp-maker create server  [options]

Options

• --http: Use HTTP transport instead of default stdio
• --cors: Enable CORS with wildcard (*) access
• --port : Specify HTTP port (only valid with --http)
• --no-install: Skip npm install and build steps
• -h, --help: Display help for the command

Example

mcp-maker create server my-mcp-server --http --port 3000 --cors

This will create a new MCP server project named my-mcp-server with HTTP transport on port 3000 and CORS enabled.

Add a Tool

mcp-maker add tool  [options]

Options

• -h, --help: Display help for the command

Example

cd my-mcp-server
mcp-maker add tool get-user-data

This will:

1. Create a new tool directory in src/tools/get-user-data
2. Create the tool implementation and index files
3. Update the main tools index to include the new tool
4. Update the toolHandler to handle the new tool

Add a Service

mcp-maker add service  [options]

Options

• -h, --help: Display help for the command

Example

cd my-mcp-server
mcp-maker add service user-service

This will:

1. Create a new service directory in src/services/user-service
2. Create the service implementation and index files
3. Update the main services index to include the new service
4. Set up proper TypeScript types and interfaces

Add a Prompt

mcp-maker add prompt

Options

• -h, --help: Display help for the command

Example

cd my-mcp-server
mcp-maker add prompt user-guidance

This will:

1. Create a new prompt directory in src/prompts/user-guidance
2. Create the prompt implementation, index, and README files
3. Update the main prompts index to include the new prompt
4. Set up proper MCP-compatible prompt structure

Add Authentication

mcp-maker add auth

Options

• -h, --help: Display help for the command

Example

cd my-mcp-server
mcp-maker add auth

This will:

1. Create a new auth directory in src/auth with all necessary structure
2. Set up three authentication types:

• Basic Authentication (username/password)
• Token Authentication (API keys, JWT, etc.)
• OAuth 2.0 Authentication (for integrating with OAuth providers)

1. Create authentication factory, service, and interfaces
2. Set up proper TypeScript types and interfaces

🏗️ Generated MCP Server Project Structure

The mcp-maker CLI scaffolds a new MCP server project with the following structure:

my-mcp-server/
├── src/
│   ├── tools/             # Individual tools
│   │   └── /   # Each tool in its own directory
│   │       ├── index.ts   # Tool implementation
│   │       └── types.ts   # Type definitions for the tool
│   │
│   ├── services/          # Service implementations
│   │   └── / # Each service in its own directory
│   │       ├── index.ts   # Service implementation
│   │       └── types.ts   # Type definitions for the service
│   │
│   ├── prompts/           # MCP-compatible prompts
│   │   └── / # Each prompt in its own directory
│   │       ├── index.ts   # Prompt export in MCP format
│   │       ├── Prompt.ts # Prompt implementation
│   │       └── README.md  # Documentation for the prompt
│   │
│   ├── auth/              # Authentication (when added)
│   │   ├── interfaces/    # Authentication interfaces
│   │   ├── methods/       # Authentication method implementations
│   │   ├── AuthFactory.ts # Factory for creating auth providers
│   │   ├── AuthService.ts # Service for authentication
│   │   └── index.ts       # Main entry point for auth
│   │
│   ├── types/             # Global TypeScript type definitions
│   ├── utils/             # Utility functions
│   ├── config.ts          # Configuration
│   └── index.ts           # Main entry point
├── tests/                 # Test files
├── .gitignore
├── package.json           # Project configuration and dependencies
├── tsconfig.json          # TypeScript configuration
└── README.md

This structure ensures consistency across all MCP server projects created with mcp-maker.

🗂️ Repository Structure

This repository contains the following files and directories:

• src/: The source code for the mcp-maker CLI utility.
• tests/: Test files for the mcp-maker CLI utility.
• README.md: This file, which provides an overview of the mcp-maker CLI utility.
• LICENSE: The license under which this project is released.
• CONTRIBUTING.md: Guidelines for contributing to this project.
• [DEVELOPMENT.md](DEVELOPMENT.md): Guidelines for developing and testing this project.
• [CODE_OF_CONDUCT.md](CODEOFCONDUCT.md): The code of conduct for this project.

🤝 Contributing

We welcome contributions! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines, including branch naming conventions and pull‑request requirements.

📄 License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

Copyright © 2025 Prakhar Yadav

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yadav-prakhar
• Source: yadav-prakhar/mcp-maker
• License: Apache-2.0
• Homepage: https://www.npmjs.com/package/mcp-maker

Install and usage instructions live in the source repository linked above.