What is Mcpctl

mcpctl is a tool for controlling the MCP execution, allowing users to discover, orchestrate, and manage MCP server instances effectively.

Use cases

Use cases include local development setups, automated testing environments, and managing multiple MCP server configurations in a unified manner.

How to use

To use mcpctl, install it via npm, ensuring Node.js 18.17.1 or higher is installed. After installation, you can use commands to discover MCP servers, orchestrate instances, and manage profiles.

Key features

Key features include MCP server discovery, orchestration of server instances, and profile management for storing server lists and configurations.

Where to use

mcpctl is used in software development and deployment environments where MCP servers are utilized for managing microservices or cloud-native applications.

MCPCTL - The MCP Execution Control Tool

MCPCTL is the CLI for managing Model Context Protocol (MCP) servers, secrets, profiles, and the control plane. Fast, reliable, and built for automation.

Install

npm install -g @vessl-ai/mcpctl
# or
yarn global add @vessl-ai/mcpctl
# or
pnpm install -g @vessl-ai/mcpctl

Documentation

• Core Concepts
• CLI Reference
• Architecture
• Development Guide
• Installation Guide
• Contributing Guide

Usage

mcpctl <command> [subcommand] [options]

Commands

Server Management

mcpctl server start -f <spec.json> [--profile <name>]
mcpctl server stop <server-name>
mcpctl server restart <server-name>
mcpctl server status <server-name>
mcpctl server list
mcpctl server remove <server-name>

Secret Management

mcpctl secret add <name> --value <value> [--source <vault|keychain|env>]
mcpctl secret get <name> [--source <vault|keychain|env>]
mcpctl secret list [--source <vault|keychain|env>]
mcpctl secret remove <name> [--source <vault|keychain|env>]

Profile Management

mcpctl profile create <name> [--description <text>] [--copy-from <name>]
mcpctl profile delete <name>
mcpctl profile list
mcpctl profile use <name>
mcpctl profile read <name>
mcpctl profile env set <key> <value> [--profile <name>]
mcpctl profile env get <key> [--profile <name>]
mcpctl profile env list [--profile <name>]
mcpctl profile env delete <key> [--profile <name>]

Toolset Management

mcpctl toolset save <name> --client <client> [--description <desc>]
# Save the current client config's toolset (servers) as a named toolset file. Optionally add a description.

mcpctl toolset load <name> --client <client>
# Load a saved toolset into the current client config. Prompts to save the current config before loading.

mcpctl toolset list [--client <client>]
# List all saved toolsets for the given client (or all clients).

Control Plane Management

mcpctl control-plane start
mcpctl control-plane stop
mcpctl control-plane restart
mcpctl control-plane status
mcpctl control-plane logs

Log Management

mcpctl log server <server-name> [--limit <number>]
mcpctl log control-plane [--limit <number>]

Configuration

All configuration, profiles, and secrets are stored in ~/.mcpctl by default.
Set DEBUG=true for verbose logging.

License

MIT License. See LICENSE for details.