CLI Reference

Complete reference for ModelFetch CLI tools including create-modelfetch and modelfetch commands.

This reference covers all available commands and options for ModelFetch CLI tools. Use --help with any command for detailed usage information.

create-modelfetch

The create-modelfetch CLI scaffolds new MCP server projects with all necessary dependencies and configuration.

Installation

No installation required. Use directly with npx:

npx create-modelfetch <project-name>

Usage

npx create-modelfetch my-mcp-server

The command will:

Prompt for project name with validation
Create project directory structure
Install dependencies automatically
Generate example MCP server code
Configure TypeScript and development tools

modelfetch CLI

The modelfetch CLI provides development, build, and deployment commands for MCP servers.

Installation

Installed automatically with create-modelfetch projects:

# Already included in your package.json
npm run dev    # Uses modelfetch dev
npm run build  # Uses modelfetch build
npm run deploy # Uses modelfetch deploy

Commands

Command	Description	Usage
`dev`	Start development server with live reload	`modelfetch dev`
`build`	Build for production	`modelfetch build`
`deploy`	Deploy to ModelFetch platform	`modelfetch deploy`
`login`	Authenticate with ModelFetch account	`modelfetch login`
`logout`	Sign out of ModelFetch account	`modelfetch logout`

Command Details

`modelfetch dev`

Starts the development server with automatic recompilation and restart on file changes.

Features:

TypeScript compilation with esbuild
Live reload on source changes
Source maps for debugging
External Node.js modules handling

`modelfetch build`

Builds the MCP server for production deployment.

Output:

dist/index.js - Minified production bundle
dist/index.js.map - Source map for debugging
dist/__modelfetch__.js - Runtime loader

`modelfetch deploy`

Deploys your MCP server to the ModelFetch platform.

`modelfetch login`

Authenticates with your ModelFetch account.

`modelfetch logout`

Signs out of your ModelFetch account.

Common Patterns

Complete Development Workflow

# Create new project
npx create-modelfetch my-server
cd my-server

# Start development
npm run dev

# Build for production
npm run build

# Test production build
npm start

# Deploy to platform
npm run deploy

Authentication Management

# Initial login
modelfetch login

# Deploy your server
modelfetch deploy

# Logout for security
modelfetch logout

Debugging Build Issues

# Clean build
rm -rf dist/
npm run build

# Test locally
npm start

# Check for TypeScript errors
npx tsc --noEmit

Getting Help

Use the --help flag with commands for detailed usage:

# General help
modelfetch --help

# Command-specific help
modelfetch dev --help
modelfetch deploy --help

Pro tip: You can also check the version with modelfetch --version to ensure you're using the latest CLI features.