What is Mcpz

mcpz is a command line interface (CLI) for managing and interacting with Model Context Protocol (MCP) servers and tools. It allows users to run, configure, and query various MCP servers seamlessly.

Use cases

Use cases for mcpz include starting specific MCP servers for model predictions, managing groups of servers for complex workflows, and configuring custom server setups for development and testing purposes.

How to use

To use mcpz, install it globally via npm or use it with npx. Access the CLI using commands like ‘mcps’ or ‘mcpz’, and utilize commands such as ‘run’, ‘add’, ‘list’, and ‘remove’ to manage your MCP configurations.

Key features

Key features of mcpz include the ability to run servers and tools, manage configurations (add/remove), query available servers, create server groups for streamlined workflows, and apply flexible filtering options.

Where to use

mcpz can be used in various fields where Model Context Protocol servers are applicable, such as machine learning, data processing, and software development environments that require server management.

VSCode Extension

The Extension is open-source and at https://github.com/jasonkneen/mcpz-vscode and in the mcspx-tweaks branch

https://github.com/jasonkneen/mcpz-vscode

mcpz cli

https://github.com/jasonkneen/mcpz-cli

Command line interface for mcpsx (Model Context Protocol Server eXecutable), allowing you to manage, query, and interact with Model Context Protocol (MCP) servers and tools.

Installation

# Install globally
npm install -g @mcpz/cli

# Or use with npx
npx @mcpz/cli

Usage

The CLI can be accessed using any of these commands:

• mcps (primary command)
• mcpz (extended alias)

# Show help
mcpz help

# Start MCPS as a stdio server
mcpz run

# Start with specific servers and tools
mcpz run --server="sleep"
mcpz run --servers="python,pytorch" --tool="predict"

# Server group management
mcpz groups add "python-stack" --servers="python,pytorch,huggingface"
mmcpzcpsx run --servers="python-stack"

# Add a new MCP configuration
mcpz add "My Server" --command "node" --args "server.js"

# List MCP configurations
mcpz list

# Remove an MCP configuration
mcpz remove "My Server"

# Use a specific MCP configuration
mcpz use "My Server"

Key Features

mcpz CLI provides powerful capabilities for working with Model Context Protocol servers:

1. Run Servers & Tools: Start MCP servers and tools individually or in combination
2. Add & Remove: Easily manage your MCP configurations
3. Query & List: View available servers and tools at any time
4. Grouping: Create and manage groups of servers and tools for simplified workflows
5. Flexible Filtering: Run specific servers, tools, or combinations

Commands

run

Start mcpz as a stdio server. This is the main command used by the VSCode extension to communicate with MCP servers.

mcpz run [options]

Options:

• -s, --server <n> - Load only a specific server
• -S, --servers <names> - Load only specific servers (comma-separated)
• -t, --tool <n> - Load only a specific tool
• -T, --tools <names> - Load only specific tools (comma-separated)

Examples:

# Load all servers and tools
mcpz run

# Load only the 'sleep' server
mcpz run --server="sleep"

# Load multiple servers
mcpz run --servers="python,pytorch"

# Load specific tools from specific servers
mcpz run --servers="python" --tools="predict,generate"

# Use a server group
mcpz run --servers="python-stack"

groups

Manage server and tool groups. Groups allow you to create collections of MCP servers and tools that can be used together.

mcpz groups <command>

Subcommands:

groups add

Create a new server group.

mcpz groups add <n> --servers="server1,server2,..."

Example:

# Create a 'python-stack' group containing multiple servers
mcpz groups add "python-stack" --servers="python,pytorch,huggingface"

# Create a 'favorites' group
mcpz groups add "favorites" --servers="openai,anthropic"

groups remove

Remove a server group.

mcpz groups remove <n>

groups list

List all server groups.

mcpz groups list

Server & Tool Groups

Groups allow you to create collections of MCP servers and tools that can be used together. This is useful for organizing related components and simplifying command-line usage.

Groups act as “virtual MCPs” - when you reference a group name with --servers or --tools, it expands to include all servers or tools in that group.

Example workflow:

# Create groups for different use cases
mcpz groups add "ai-models" --servers="openai,anthropic,llama"
mcpz groups add "data-tools" --servers="pandas,numpy,sklearn"

# Use a specific group
mcpz run --servers="ai-models"

# Combine groups with individual servers/tools
mcpz run --servers="ai-models,custom-server" --tools="predict"

add

Add a new MCP configuration.

mcpz add <n> [options]

Options:

• -c, --command <command> - Command to run the MCP server
• -a, --args <args> - Arguments for the command (comma-separated)
• -e, --env <env> - Environment variables (key=value,key2=value2)

Example:

mcpz add "GPT Server" --command "node" --args "server.js,--port=3000" --env "API_KEY=abc123,DEBUG=true"

remove

Remove an MCP configuration.

mcpz remove <n>

list

List all MCP configurations.

mcpz list

use

Use a specific MCP configuration.

mcpz use <n>

help

Display help information.

mcpz help

Configuration

MCPSX CLI uses the configuration file located at ~/.mcpsx/config.json. This file is shared with the MCPS VSCode extension.

███████████████████████████████████████████████████████████████████████████████████████████████████████████████
█        ███        ██████            ██               ███               █████████      ███      █████████    █
█                    ███              ██                ██               █████████░░░░░░███░░░░░░     ████░░░░█
█░░░░░░░░░░░░░░░░░░░░██░░░░░░░░░░░░░░░██░░░░░░░░░░░░░░░░██░░░░▓░░░░░░░░░ ██████████████████▒▒▒▒▒▒▒▒▒▒▒████░░░░█
█░░░░▒██▒░░░░██▒░░░░░██░░░░▒▒▒▒▒▒▒▒▒▒▒██░░░░░░▒██▒░░░░░░██▒▒███░░░░▒▒▒▒███████████░░░░░░███▒▒▒▒▒▒▒▒▒▒▒████▒▒▒▒█
█▒▒▒▒▒██▒▒▒▒▒██▒▒▒▒▒▒██▒▒▒▒▒▒▒██████████▒▒▒▒▒▒▒██▒▒▒▒▒▒▒█████░░▒▒▒▒▒▒█████  ░░▒███░░░░░░███▒▒▒▒▒██████████▒▒▒▒█
█▒▒▒▒▒██▒▒▒▒▒██▒▒▒▒▒▒██▒▒▒▒▒▒▒░░░░░░░░██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒███░░░▒▒▒▒▒▒▒██████ ▒▒▓▓███▒▒▒▒▒▒███▒▒▒▒▒░░░░░░████▒▒▒▒█
█▒▒▒▒▒██▒▒▒▒▒██▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒████▒▒▒▒▒▒▒▒▒░░░░░░█▓▓▓▓████▒▒▒▒▒▒███▒▒▒▒▒▒▒▒▒▒▒█████████
█▒▒▒▒▒██▒▒▒▒▒██▒▒▒▒▒▒███▒▒▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒███████████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒█████████▒▒▒▒▒▒████▒▒▒▒▒▒▒▒▒▒████░░░░█
█▒▒▒▒▒██▒▒▒▒▒██▒▒▒▒▒▒█████▒▒▒▒▒▒▒▒▒▒▒▒██▒▒▒▒▒▒▒███████████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒█████████▒▒▒▒▒▒█████▒▒▒▒▒▒▒▒▒████▒▒▒▒█
███████████████████████████████████████████████████████████████████████████████████████████████████████████████