mcpc

MCP (Model Context Protocol) Server Template Generator

Introduction

mcpc is a command-line tool that generates scaffolding for MCP (Model Context Protocol) server projects. It helps you quickly set up a properly structured project with all necessary files and configurations.

Features

• Generate MCP server templates for TypeScript or Python
• Support for multiple package managers (pnpm, yarn, npm for TypeScript; uv for Python)
• Automatic dependency installation
• System dependency validation
• Git repository initialization
• Complete project structure following official MCP documentation
• Python test mode for verifying server functionality without Claude
• Configuration files and best practices included

Installation

Prerequisites

• Rust and Cargo (can be installed via rustup)

Build and Install

Using Make:

# Build and install in one step
make install

Or using Cargo directly:

# Install from local repository
cargo install --path .

Usage

Basic usage:

mcpc project_name [options]

Options:

• -l, --language: Programming language to use (py/python, ts/typescript, default: typescript)
• -t, --tool: Package manager tool to use:
  • For TypeScript: pnpm (default), yarn, npm
  • For Python: uv (default)

Examples:

# Create a TypeScript project named 'weather-api' using pnpm
mcpc weather-api -l ts -t pnpm

# Create a Python project named 'mcp-server' using uv
mcpc mcp-server -l py -t uv

Generated Project Structure

TypeScript Project

project_name/
├── .gitignore
├── .prettierignore
├── .prettierrc
├── package.json
├── README.md
├── tsconfig.json
├── build/
└── src/
    └── index.ts

Python Project

project_name/
├── .gitignore
├── pyproject.toml
├── README.md
├── requirements.txt
├── server.py
└── .venv/

Using Generated Projects

Python

# Activate virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies (if not already installed)
uv pip install -r requirements.txt

# Test server functionality without Claude
python server.py --test

# Run server for Claude integration
python server.py

TypeScript

# Install dependencies (if not already installed)
pnpm install  # or: yarn / npm install

# Build the project
pnpm run build  # or: yarn build / npm run build

# Run server
node build/index.js

Claude for Desktop Integration

To integrate with Claude for Desktop, configure your server in Claude's configuration file:

{
  "mcpServers": {
    "weather": {
      "command": "uv",  // or "node" for TypeScript
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PROJECT",
        "run",
        "server.py"  // or "build/index.js" for TypeScript
      ]
    }
  }
}

Development

Available Make Commands

make              # Build the project (same as 'make build')
make build        # Build the project in debug mode
make release      # Build the project in release mode
make install      # Build in release mode and install
make run          # Run the project in debug mode
make run-release  # Run the project in release mode
make test         # Run tests
make docs         # Generate and open documentation
make clean        # Clean build artifacts
make fmt          # Format code with rustfmt
make check        # Check for compilation errors
make clippy       # Run Clippy lints

Build from Source

git clone https://github.com/yourusername/mcpc.git
cd mcpc
make install

License

This project is licensed under the MIT License - see the LICENSE file for details.