modelcontextprotocol

# modelcontextprotocol > CLI tool and utilities for scaffolding Model Context Protocol (MCP) projects with enhanced logging Create production-ready MCP servers and clients in seconds with built-in **loguru** logging and optional **PostHog** analytics. ## Features - **Quick Scaffolding** - Generate MCP projects instantly - **Enhanced Logging** - Beautiful logs with loguru out of the box - **Analytics** - Optional PostHog integration for usage tracking - **Beautiful CLI** - Rich terminal UI with helpful prompts - **Best Practices** - Templates follow MCP best practices - **uvx Compatible** - No installation needed with uvx ## Quick Start ### With uvx (No Installation) ```bash # Interactive mode uvx modelcontextprotocol create # Direct creation uvx modelcontextprotocol create my-server --type server ``` ### With pip/uv ```bash # Install pip install modelcontextprotocol # or uv pip install modelcontextprotocol # Create a project modelcontextprotocol create # or mcp-create server my-weather-server ``` ## 📖 Usage ### Interactive Mode Simply run without arguments for an interactive experience: ```bash modelcontextprotocol create ``` You'll be prompted for: - Project name - Project type (server/client) - Template type (basic/advanced) - Project path ### Command Line Mode ```bash # Create a basic server mcp-create server my-server # Create an advanced server with PostHog mcp-create server my-server \ --template advanced \ --posthog-key YOUR_KEY # Create a client mcp-create client my-client # Specify custom path mcp-create server my-server --path ./projects/my-server ``` ### Environment Variables ```bash # PostHog configuration export POSTHOG_API_KEY="your-api-key" export POSTHOG_HOST="https://app.posthog.com" # Now create with analytics mcp-create server my-server --template advanced ``` ## Generated Project Structure ### Basic Server ``` my-server/ ├── server.py # Main server file with loguru ├── pyproject.toml # Project configu…