mcpctl is a command-line tool for controlling MCP (Model Context Protocol) server execution and management.
- Search MCP servers across multiple repositories
- Add and manage custom repositories
- Interactive LLM-powered search (OpenAI integration)
- Registry-based server indexing
- Run MCP servers locally
- Connect to existing server instances
- Manage server sessions
- Monitor server status and health
- View daemon, client, server, and session logs
- Real-time log following
- Multiple log viewer support (less, tail, bat, fzf)
- Filtered log viewing by date, window, and instance
- Profile-based configuration management
- Environment variable and secret management
- Custom registry configuration
- Client-specific settings
# Install globally (requires sudo/admin privileges)
sudo npm install -g @vessl-ai/mcpctl
# Alternative package managers
sudo pnpm install -g @vessl-ai/mcpctl
sudo yarn global add @vessl-ai/mcpctl- Search for MCP Servers
# Search by registry and name
mcpctl search --registry glama --name my-mcp-server
# Search with query
mcpctl search --query 'slack' --registry glama --limit 10
# Interactive LLM search
export OPENAI_API_KEY=<your-key>
mcpctl search --query 'slack' --use-llm-interactive- Install to Clients
mcpctl install --client claude --server-name my-mcp-server \
--command 'npx -y @wonderwhy-er/desktop-commander'- Manage Servers and Sessions
# List servers
mcpctl server list
# List sessions
mcpctl session list- View Logs
# View daemon logs
mcpctl logs daemon view
# View client logs
mcpctl logs client view claude|cursor|...
# View server logs
mcpctl logs server view my-server
# View session logs
mcpctl logs session view session-123# Create a profile
mcpctl profile create my-profile
# Set environment variables
mcpctl profile set-env my-profile -s real-slack SLACK_BOT_TOKEN=your-token
# Use profile for connection
mcpctl session connect --profile my-profile --server-name real-slack# Add custom registry
mcpctl registry add --name my-registry --url https://github.com/my-registry- Node.js 18.17.1 or higher
- Operating System: Linux, macOS, or Windows
- Check daemon status:
mcpctl daemon status- View logs:
- Linux/macOS:
/var/log/mcpctl/daemon.log - Windows:
C:\ProgramData\mcpctl\logs\daemon.log
- Restart daemon:
# Linux/macOS
sudo mcpctl daemon stop
sudo mcpctl daemon start
# Windows (Run as Administrator)
mcpctl daemon stop
mcpctl daemon start- Registry indexing for faster search
- Profile-based MCP Server Set management
- Enhanced semantic search capabilities
- Container / Kubernetes based MCP Server instance management
MIT License - See LICENSE for details