MCP-CLI

The easiest way to install and manage MCP servers with Docker support

What is MCP-CLI?

MCP-CLI is a command-line tool that simplifies the installation and management of Model Context Protocol servers. It features Docker isolation, multi-registry search, automatic configuration for popular MCP clients, and seamless integration with AurraCloud's hosted services.

One-command setup
Docker isolation
Multi-registry support
Installation

Install Globally via npm

npm install -g @aurracloud/mcp-cli

Verify Installation

mcp --version
Quick Start

1. Install an MCP Server

Install any MCP server from npm or other registries with automatic client configuration:

mcp install @modelcontextprotocol/server-sequential-thinking

This installs the sequential thinking server from the npm registry.

2. Login to AurraCloud (Optional)

Connect to AurraCloud for hosted MCP servers and cloud features:

mcp login

3. List Available Cloud Servers

mcp list-cloud

4. Publish Your Own Server

Share your MCP server with the community:

mcp publish

Run this from your MCP server project directory to publish it to the registry.

Commands Reference

Installation Commands

mcp install <package> [options]

Install an MCP server from npm, GitHub, or other registries

Available Options:

  • -v, --verbose - Enable verbose output
  • -d, --debug - Enable debug output
  • -q, --quiet - Suppress all output except errors

Management Commands

mcp list [options]

List all installed MCP servers for a client

mcp uninstall [options] <package>

Uninstall an MCP server

mcp info [options] <package>

Get comprehensive information about a package from integrated registries

mcp upgrade

Upgrade mcp-cli to the latest version

Cloud Commands

mcp login [options]

Authenticate with the MCP registry to enable cloud installation

mcp logout [options]

Remove authentication credentials for the MCP registry

mcp list-cloud [options]

List all available cloud SSE tools from aurracloud.com

Publishing Commands

mcp publish [options]

Publish your MCP server to the AurraCloud registry

Available Options:

  • -d, --directory <path> - Specify project directory (default: current directory)
  • -s, --slug <slug> - Override the generated slug
  • -c, --category <category> - Override the detected category
  • -r, --registry <url> - Use a custom registry URL
  • --json - Output result as JSON (useful for CI/CD)
Usage Examples

Install Popular MCP Servers

Sequential Thinking Server

mcp install @modelcontextprotocol/server-sequential-thinking

Filesystem Server

mcp install @modelcontextprotocol/server-filesystem

GitHub Server

mcp install @modelcontextprotocol/server-github

Additional Commands

Get Package Information

mcp info @modelcontextprotocol/server-sequential-thinking

List Installed Servers

mcp list

Uninstall a Server

mcp uninstall @modelcontextprotocol/server-sequential-thinking

Publish Your Server

mcp publish --category productivity
Publishing Your MCP Server

Share your MCP server with the community by publishing it to the AurraCloud registry. The CLI automatically detects your project configuration and generates the necessary metadata.

Quick Publish

Publish your MCP server from the project directory:

mcp publish

This command automatically detects your project type and extracts metadata from your configuration files.

Supported Project Types

Node.js Projects

Requires package.json with mcpServer configuration

Auto-detected from:

  • Package name, version, description
  • Author, license, repository
  • Keywords for categorization
  • MCP server capabilities

Python Projects

Requires pyproject.toml with [tool.mcp-server] configuration

Auto-detected from:

  • Project metadata in pyproject.toml
  • Authors, license, repository
  • Keywords and classifiers
  • MCP server configuration

Publishing Examples

Publish with Custom Slug

mcp publish --slug my-awesome-server

Publish with Custom Category

mcp publish --category productivity

Publish from Different Directory

mcp publish --directory ./my-mcp-server

CI/CD Integration (JSON Output)

mcp publish --json > publish-result.json

What Gets Published

  • Metadata: Name, description, version, author, license
  • Source Information: Repository URL, npm/PyPI package links
  • Categorization: Auto-detected or manually specified category
  • Capabilities: Available tools, resources, and prompts
  • Documentation: README content (if available)
  • Examples: Auto-generated usage examples based on capabilities
  • Tags: Keywords from package metadata

Example Configuration Files

Node.js (package.json)

{
  "name": "@myorg/weather-server",
  "version": "1.0.0",
  "description": "MCP server for weather data",
  "author": "John Doe <john@example.com>",
  "license": "MIT",
  "repository": "https://github.com/myorg/weather-server",
  "keywords": ["weather", "api", "mcp", "productivity"],
  "mcpServer": {
    "name": "weather-server",
    "description": "Provides weather information and forecasts",
    "tools": [
      {
        "name": "get_weather",
        "description": "Get current weather for a location"
      }
    ]
  }
}

Python (pyproject.toml)

[project]
name = "weather-server"
version = "1.0.0"
description = "MCP server for weather data"
authors = [{name = "John Doe", email = "john@example.com"}]
license = {text = "MIT"}
keywords = ["weather", "api", "mcp", "productivity"]

[project.urls]
Repository = "https://github.com/myorg/weather-server"

[tool.mcp-server]
name = "weather-server"
description = "Provides weather information and forecasts"

[[tool.mcp-server.tools]]
name = "get_weather"
description = "Get current weather for a location"
Configuration

Manual Configuration

After installing MCP servers, you'll need to manually configure your MCP clients to use them. The CLI will provide installation paths and configuration details.

Claude Desktop

Add server configuration to claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/

Windows: %APPDATA%\Claude\

Cursor IDE

Configure MCP settings in Cursor preferences

Settings → Features → Model Context Protocol

Global Options

All commands support these global options for controlling output and debugging:

  • -v, --verbose - Enable verbose output for detailed information
  • -d, --debug - Enable debug output for troubleshooting
  • -q, --quiet - Suppress all output except errors
  • -V, --version - Display the current version
  • -h, --help - Display help for any command
Troubleshooting

Common Issues

Package not found

Verify the package name and registry. Use mcp info <package> to check if the package exists.

Permission denied

Run with sudo on Linux/macOS or run terminal as administrator on Windows.

Installation failed

Check your internet connection and ensure you have the latest version of Node.js installed.

Client not detecting server

Manually configure your MCP client with the server details provided after installation.

    We use cookies to enhance your experience, analyze site usage, and personalize content.

    AurraCloud - a Monemetrics Product