Installation

Prerequisites

MetaMCP requires Node.js 20 or later.

Check your version:

node --version

If the output is below v20.0.0, upgrade Node.js before continuing. We recommend using nvm or the official installer at nodejs.org.

No installation required. Run MetaMCP directly:

npx @mentu/metamcp --config .mcp.json

This downloads and executes the latest version of MetaMCP. It reads the config file and starts the meta-MCP server on stdio.

💡

This is the recommended approach for most users. It always runs the latest version and requires no global install.

If you prefer a persistent global install:

npm install -g @mentu/metamcp

Then run:

metamcp --config .mcp.json

Global install is useful when you run MetaMCP frequently and want to avoid the npx download on each invocation.

Clone the repository and build locally:

git clone https://github.com/mentu-ai/metamcp.git
cd metamcp
npm ci
npm run build

Run the built version:

node dist/index.js --config .mcp.json

Building from source is useful for development or running a specific commit.

Check that MetaMCP is available and reports the expected version:

metamcp --version

View all available CLI flags:

metamcp --help

If metamcp is not found after a global install, ensure your npm global bin directory is in your PATH.