openmcp-cli

OpenMCP CLI

CLI tool for OpenMCP - Quickly setup and run OpenMCP development environment.

Installation

npm install -g openmcp-cli

Requirements

• Node.js >= 18.0.0
• Git
• npm, yarn, or pnpm

Usage

Initialize a new project

openmcp init my-project
cd my-project

Start development mode

Start both service (backend) and renderer (frontend) in development mode:

openmcp dev

Start only the backend service:

openmcp dev --service-only

Start only the frontend renderer:

openmcp dev --renderer-only

Specify a custom port for the service:

openmcp dev --port 9000

Start production mode

openmcp start

Check for updates

openmcp update --check

Update to latest version

openmcp update

Commands

Command	Description
init [project-name]	Initialize a new OpenMCP project
dev [project-path]	Start development servers (service + renderer)
start [project-path]	Start production servers
update [project-path]	Update project to the latest version
-v, --version	Display version number
-h, --help	Display help information

Project Structure

After initialization, your project will have the following structure:

my-project/
├── service/          # Backend service (Node.js + WebSocket)
│   ├── src/
│   └── package.json
├── renderer/         # Frontend UI (Vue 3 + Vite)
│   ├── src/
│   └── package.json
├── src/              # VSCode extension source
├── package.json      # Root package.json
└── ...

Development Workflow

• Create a new project:

  openmcp init my-project
  cd my-project
  

• Start development servers:

  openmcp dev
  

  This will start:

  • Service (Backend) on port 8282
  • Renderer (Frontend) on port 5173 (Vite default)

• Open your browser:

  Navigate to http://localhost:5173 to access the OpenMCP interface.

• Make changes:

  Both service and renderer support hot-reload during development.

Troubleshooting

Port already in use

If port 8282 is already in use, you can specify a different port:

openmcp dev --port 9000

Permission denied on global install

If you encounter permission issues when installing globally:

# Option 1: Use npx (no global install needed)
npx openmcp-cli init my-project

# Option 2: Change npm's default directory
# See: https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally

Git not found

Make sure Git is installed and available in your PATH:

git --version

License

MIT

Links

• OpenMCP Documentation
• GitHub Repository