🚨 ARCHIVED — NEW CLI AVAILABLE 🚨

This project is no longer maintained.
Please use the new and actively supported CLI:
👉 @mcp-use/cli on npm

npm install --global @mcp-use/cli

Open Source and Open Model CLI for MCP

A CLI tool for interacting with Model Context Protocol (MCP) servers using natural language.

Built with mcp-use, build your own MCP application with our SDKs:

Python mcp-use/mcp-use

Typescript mcp-use/mcp-use-ts

Features

• 🤖 Natural language interface for MCP servers
• 💬 Interactive chat interface with tool call visualization
• ⚡ Direct integration with mcp-use (no API layer needed)
• 🚀 Single command installation
• 🔄 Over a dozen LLM providers (OpenAI, Anthropic, Google, Mistral, Groq, Cohere, and more)
• ⚙️ Slash commands for configuration (like Claude Code)
• 🔑 Smart API key prompting - automatically asks for keys when needed
• 💾 Persistent secure storage - encrypted keys and settings saved across sessions

Demo video

Install

$ npm install --global @mcp-use/cli

Quick Start

1. Install and run:

   $ npm install --global @mcp-use/cli
   $ mcp-use
   

2. Choose your model (CLI handles API key setup automatically):

   # Just pick a model - that's it!
   /model openai gpt-4o
   /model anthropic claude-3-5-sonnet-20240620
   /model google gemini-1.5-pro
   /model groq llama-3.1-70b-versatile
   /model ollama llama3
   
   # CLI will prompt: "Please enter your OPENAI API key:"
   # Paste your key and start chatting immediately!
   

3. Get API keys when prompted from providers like:

   • OpenAI
   • Anthropic
   • Google AI
   • Mistral
   • Groq
   • Cohere

Keys are stored securely encrypted in ~/.mcp-use-cli/config.json and persist across sessions.

Alternative Setup

If you prefer environment variables:

export OPENAI_API_KEY=your_key_here
export ANTHROPIC_API_KEY=your_key_here
# Then just run: mcp-use

Usage

$ mcp-use --help

  Usage
    $ mcp-use

  Options
    --name        Your name (optional)
    --config      Path to MCP configuration file (optional)

  Examples
    $ mcp-use
    $ mcp-use --name=Jane

  Environment Variables
    <PROVIDER>_API_KEY    Set API keys (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY)

  Setup
    1. Run: mcp-use
    2. Use /model or /setkey to configure an LLM.
    3. Use /server commands to connect to your tools.
    4. Start chatting!

Connecting to Tools (MCP Servers)

This CLI is a client for Model Context Protocol (MCP) servers. MCP servers act as tools that the AI can use. You need to connect the CLI to one or more servers to give it capabilities.

You can manage servers with the /server commands:

# Add a new server configuration by pasting its JSON definition
/server add

# List configured servers
/servers

# Connect to a configured server
/server connect <server-name>

# Disconnect from a server
/server disconnect <server-name>

When you add a server, you'll be prompted for its JSON configuration. Here are examples for local and remote servers:

Local Server Example (e.g., a filesystem tool):

{
	"mcpServers": {
		"filesystem-tool": {
			"command": "npx",
			"args": [
				"-y",
				"@modelcontextprotocol/server-filesystem",
				"/path/to/your/project"
			],
			"env": {}
		}
	}
}

Remote Server Example (e.g., an SSE endpoint):

{
	"mcpServers": {
		"remote-tool": {
			"url": "http://127.0.0.1:8000/sse"
		}
	}
}

This configuration would be pasted directly into the CLI after running /server add.

Slash Commands

Switch LLM providers and configure settings using slash commands:

# Set API keys (stored securely)
/setkey openai sk-1234567890abcdef...
/setkey anthropic ant_1234567890abcdef...
/clearkeys  # Clear all stored keys

# Switch models
/model openai gpt-4o
/model anthropic claude-3-5-sonnet-20240620
/model google gemini-1.5-pro
/model mistral mistral-large-latest
/model groq llama-3.1-70b-versatile

# List available models
/models

# Server Management
/server add
/servers
/server connect <name>
/server disconnect <name>

# Configuration
/config temp 0.5
/config tokens 4000

# Status and help
/status
/help

Chat Examples

• "List files in the current directory"
• "Create a new file called hello.txt with the content 'Hello, World!'"
• "Search for files containing 'TODO'"
• "What's the structure of this project?"

Architecture

This CLI uses:

• Frontend: React + Ink for the terminal UI
• Agent: mcp-use MCPAgent for LLM + MCP integration
• LLM: Your choice of 12+ providers
• Transport: Direct TypeScript integration (no API layer)

Privacy & Telemetry

This package uses Scarf to collect basic installation analytics to help us understand how the package is being used. This data helps us improve the tool and prioritize features.

What data is collected?

Scarf collects:

• Operating system information
• IP address (used only for company lookup, not stored)
• Limited dependency tree information (hashed for privacy)

No personally identifying information is stored.

How to disable telemetry

You can opt out of analytics in several ways:

Option 1: Environment variable

export SCARF_ANALYTICS=false

Option 2: Standard Do Not Track

export DO_NOT_TRACK=1

Option 3: For package maintainers If you distribute a package that depends on this CLI, you can disable analytics for all your downstream users by adding this to your package.json:

{
	"scarfSettings": {
		"enabled": false
	}
}

For more information about Scarf and privacy, visit scarf.sh.

License

MIT