The npm for AI agent tools - install MCP servers without the JSON hell. Discover and install 190+ AI agent tools with one command. Includes stacks, badges, and achievements. Free and open source.
npm install @openconductor/clibash
Install globally
npm install -g @openconductor/cli
Discover MCP servers
openconductor discover "memory"
Install a server
openconductor install mcp-memory
List installed servers
openconductor list
`
š¦ Installation
$3
`bash
npm install -g @openconductor/cli
`
$3
`bash
git clone https://github.com/epicmotionSD/openconductor.git
cd openconductor/packages/cli
pnpm install
pnpm link --global
`
$3
`bash
openconductor --version
openconductor --help
`
š§ Commands
$3
Search for MCP servers in the registry.
`bash
Browse all servers
openconductor discover
Search for memory servers
openconductor discover "memory"
Filter by category
openconductor discover --category database
Filter by tags
openconductor discover --tags memory,semantic
Show only verified servers
openconductor discover --verified
Limit results
openconductor discover memory --limit 5
`
Options:
- -c, --category - Filter by category (memory, filesystem, database, api, search, communication, monitoring, development, custom)
- -t, --tags - Filter by tags
- --verified - Show only verified servers
- -l, --limit - Number of results (max 50, default 10)
$3
Install an MCP server to your Claude Desktop configuration.
`bash
Basic installation
openconductor install mcp-memory
Custom config file location
openconductor install postgres --config ./my-config.json
Specify custom port
openconductor install github --port 8090
Skip confirmation prompts
openconductor install filesystem --yes
Preview changes without installing
openconductor install slack --dry-run
Force reinstall if already exists
openconductor install mcp-memory --force
`
Options:
- --config - Custom config file path
- --port - Custom port number (1024-65535)
- --force - Force overwrite if server already exists
- --dry-run - Show what would be installed without making changes
- -y, --yes - Skip confirmation prompts
$3
List all installed MCP servers with status information.
`bash
List all installed servers
openconductor list
Use custom config file
openconductor list --config ./my-config.json
Output as JSON
openconductor list --format json
`
Options:
- --config - Custom config file path
- --format - Output format (table, json)
$3
Remove an installed MCP server.
`bash
Remove a server
openconductor remove mcp-memory
Skip confirmation
openconductor remove postgres --yes
Use custom config file
openconductor remove github --config ./my-config.json
`
Options:
- --config - Custom config file path
- -y, --yes - Skip confirmation prompts
$3
Update installed MCP servers to their latest versions.
`bash
Update all servers
openconductor update
Update specific server
openconductor update mcp-memory
Use custom config file
openconductor update --config ./my-config.json
`
Options:
- --config - Custom config file path
$3
Initialize OpenConductor configuration with setup wizard.
`bash
Interactive setup
openconductor init
Force overwrite existing config
openconductor init --force
`
Options:
- -f, --force - Overwrite existing configuration
$3
Manage anonymous analytics preferences.
`bash
Show analytics information
openconductor analytics
Enable analytics
openconductor analytics --enable
Disable analytics
openconductor analytics --disable
`
Options:
- --enable - Enable anonymous usage tracking
- --disable - Disable anonymous usage tracking
$3
List all available curated stacks (collections of servers with system prompts).
`bash
Show all available stacks
openconductor stack list
`
Output:
`text
š¦ Available Stacks
ā” Essential Stack
Everything you need to get started
5 servers | 103 installs
Install: openconductor stack install essential
š§āš» Coder Stack
Build, debug, and deploy like a senior engineer
6 servers | 42 installs
Install: openconductor stack install coder
š” Stacks include pre-configured system prompts for Claude Desktop
`
$3
Install a complete stack (all servers + system prompt).
`bash
Install the Coder Stack
openconductor stack install coder
Force reinstall servers
openconductor stack install essential --force
`
What happens:
1. Installs all servers in the stack
2. Adds them to Claude Desktop config
3. Copies optimized system prompt to clipboard
4. Shows instructions for adding prompt to Claude
Options:
- -f, --force - Force reinstall servers that are already installed
$3
View details about a specific stack before installing.
`bash
Show details for Coder Stack
openconductor stack show coder
`
Output:
`text
š§āš» Coder Stack
Build, debug, and deploy like a senior engineer
š¦ Included Servers:
1. github-mcp ā 1,234
2. postgresql-mcp ā 856
3. filesystem-mcp ā 2,103
... (and 3 more)
š Stats:
Servers: 6
Installs: 42
š Install this stack:
openconductor stack install coder
`
$3
Generate a shareable URL for a stack.
`bash
Create share link for Coder Stack
openconductor stack share coder
`
Output:
`text
š Share this stack:
https://openconductor.ai/s/coder
š¦ Installation command:
$ openconductor stack install coder
`
šÆ Examples
$3
`bash
1. Discover memory-related servers
openconductor discover memory
2. Install MCP Memory
openconductor install mcp-memory
3. Verify installation
openconductor list
4. Configure environment (if needed for the server)
export MCP_SERVER_API_KEY=your_key_here
5. Restart Claude Desktop
`
$3
`bash
Install multiple servers
openconductor install mcp-memory
openconductor install filesystem-mcp
openconductor install github-mcp
Check status
openconductor list
Update all
openconductor update
Remove one
openconductor remove filesystem-mcp
`
$3
`bash
Use custom config location
export CLAUDE_CONFIG_PATH="/path/to/custom/config.json"
Or specify per command
openconductor install postgres --config ./custom-config.json
openconductor list --config ./custom-config.json
`
š Configuration
OpenConductor automatically detects your Claude Desktop configuration location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
$3
`json
{
"mcpServers": {
"mcp-memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"PORT": "8080"
}
},
"filesystem": {
"command": "filesystem-mcp",
"args": ["--root", "./workspace"],
"env": {
"PORT": "8081"
}
}
}
}
`
š Troubleshooting
$3
ā "Server not found"
`bash
Check spelling and search registry
openconductor discover your-server-name
List all available servers
openconductor discover
`
ā "Permission denied"
`bash
macOS/Linux: Use sudo for global installations
sudo openconductor install server-name
Windows: Run as Administrator
`
ā "Port already in use"
`bash
Specify custom port
openconductor install server-name --port 8090
Check current allocations
openconductor list
`
ā "Registry unreachable"
`bash
Check internet connection
ping openconductor.ai
Use local API for development
export OPENCONDUCTOR_API_URL=https://openconductor-api.vercel.app/v1
`
$3
Enable debug logging for detailed troubleshooting:
`bash
export DEBUG=true
openconductor install problematic-server
`
$3
`bash
Backup and reset configuration
openconductor init --force
Or manually backup
cp ~/.config/claude/claude_desktop_config.json ~/backup-config.json
`
š ļø Development
$3
`bash
Clone repository
git clone https://github.com/epicmotionSD/openconductor.git
cd openconductor/packages/cli
Install dependencies
pnpm install
Link for global testing
pnpm link --global
Test locally
openconductor discover
`
$3
`bash
Run automated tests
./test-cli.sh
Test against local API
export OPENCONDUCTOR_API_URL=https://openconductor-api.vercel.app/v1
openconductor discover --limit 5
`
$3
1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make changes and test: ./test-cli.sh
4. Submit a pull request
š Analytics
OpenConductor CLI collects anonymous usage data to improve the user experience. This includes:
- ā
Commands used (discover, install, etc.)
- ā
Installation success/failure rates
- ā
Popular MCP servers
- ā
Error frequency
What we DON'T collect:
- ā Personal information
- ā File paths or contents
- ā Environment variables
- ā Server configurations
$3
`bash
Disable analytics
openconductor analytics --disable
Enable analytics
openconductor analytics --enable
View analytics status
openconductor analytics
``