@microagents/mcp-runner v0.0.11

@microagents/mcp-runner

MicroAgents MCP Runner

• Usage
• Commands

Usage

$ npm install -g @microagents/mcp-runner
$ mcp-runner COMMAND
running command...
$ mcp-runner (--version)
@microagents/mcp-runner/0.0.11 darwin-arm64 node-v20.19.0
$ mcp-runner --help [COMMAND]
USAGE
  $ mcp-runner COMMAND
...

Commands

• mcp-runner help [COMMAND]
• mcp-runner plugins
• mcp-runner plugins add PLUGIN
• mcp-runner plugins:inspect PLUGIN...
• mcp-runner plugins install PLUGIN
• mcp-runner plugins link PATH
• mcp-runner plugins remove [PLUGIN]
• mcp-runner plugins reset
• mcp-runner plugins uninstall [PLUGIN]
• mcp-runner plugins unlink [PLUGIN]
• mcp-runner plugins update
• mcp-runner run [PACKAGE]

mcp-runner help [COMMAND]

Display help for mcp-runner.

USAGE
  $ mcp-runner help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for mcp-runner.

See code: @oclif/plugin-help

mcp-runner plugins

List installed plugins.

USAGE
  $ mcp-runner plugins [--json] [--core]

FLAGS
  --core  Show core plugins.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List installed plugins.

EXAMPLES
  $ mcp-runner plugins

See code: @oclif/plugin-plugins

mcp-runner plugins add PLUGIN

Installs a plugin into mcp-runner.

USAGE
  $ mcp-runner plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]

ARGUMENTS
  PLUGIN...  Plugin to install.

FLAGS
  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
  -h, --help     Show CLI help.
  -s, --silent   Silences npm output.
  -v, --verbose  Show verbose npm output.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Installs a plugin into mcp-runner.

  Uses npm to install plugins.

  Installation of a user-installed plugin will override a core plugin.

  Use the MCP_RUNNER_NPM_LOG_LEVEL environment variable to set the npm loglevel.
  Use the MCP_RUNNER_NPM_REGISTRY environment variable to set the npm registry.

ALIASES
  $ mcp-runner plugins add

EXAMPLES
  Install a plugin from npm registry.

    $ mcp-runner plugins add myplugin

  Install a plugin from a github url.

    $ mcp-runner plugins add https://github.com/someuser/someplugin

  Install a plugin from a github slug.

    $ mcp-runner plugins add someuser/someplugin

mcp-runner plugins:inspect PLUGIN...

Displays installation properties of a plugin.

USAGE
  $ mcp-runner plugins inspect PLUGIN...

ARGUMENTS
  PLUGIN...  [default: .] Plugin to inspect.

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Displays installation properties of a plugin.

EXAMPLES
  $ mcp-runner plugins inspect myplugin

See code: @oclif/plugin-plugins

mcp-runner plugins install PLUGIN

Installs a plugin into mcp-runner.

USAGE
  $ mcp-runner plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]

ARGUMENTS
  PLUGIN...  Plugin to install.

FLAGS
  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
  -h, --help     Show CLI help.
  -s, --silent   Silences npm output.
  -v, --verbose  Show verbose npm output.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Installs a plugin into mcp-runner.

  Uses npm to install plugins.

  Installation of a user-installed plugin will override a core plugin.

  Use the MCP_RUNNER_NPM_LOG_LEVEL environment variable to set the npm loglevel.
  Use the MCP_RUNNER_NPM_REGISTRY environment variable to set the npm registry.

ALIASES
  $ mcp-runner plugins add

EXAMPLES
  Install a plugin from npm registry.

    $ mcp-runner plugins install myplugin

  Install a plugin from a github url.

    $ mcp-runner plugins install https://github.com/someuser/someplugin

  Install a plugin from a github slug.

    $ mcp-runner plugins install someuser/someplugin

See code: @oclif/plugin-plugins

mcp-runner plugins link PATH

Links a plugin into the CLI for development.

USAGE
  $ mcp-runner plugins link PATH [-h] [--install] [-v]

ARGUMENTS
  PATH  [default: .] path to plugin

FLAGS
  -h, --help          Show CLI help.
  -v, --verbose
      --[no-]install  Install dependencies after linking the plugin.

DESCRIPTION
  Links a plugin into the CLI for development.

  Installation of a linked plugin will override a user-installed or core plugin.

  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
  command will override the user-installed or core plugin implementation. This is useful for development work.


EXAMPLES
  $ mcp-runner plugins link myplugin

See code: @oclif/plugin-plugins

mcp-runner plugins remove [PLUGIN]

Removes a plugin from the CLI.

USAGE
  $ mcp-runner plugins remove [PLUGIN...] [-h] [-v]

ARGUMENTS
  PLUGIN...  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ mcp-runner plugins unlink
  $ mcp-runner plugins remove

EXAMPLES
  $ mcp-runner plugins remove myplugin

mcp-runner plugins reset

Remove all user-installed and linked plugins.

USAGE
  $ mcp-runner plugins reset [--hard] [--reinstall]

FLAGS
  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
  --reinstall  Reinstall all plugins after uninstalling.

See code: @oclif/plugin-plugins

mcp-runner plugins uninstall [PLUGIN]

Removes a plugin from the CLI.

USAGE
  $ mcp-runner plugins uninstall [PLUGIN...] [-h] [-v]

ARGUMENTS
  PLUGIN...  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ mcp-runner plugins unlink
  $ mcp-runner plugins remove

EXAMPLES
  $ mcp-runner plugins uninstall myplugin

See code: @oclif/plugin-plugins

mcp-runner plugins unlink [PLUGIN]

Removes a plugin from the CLI.

USAGE
  $ mcp-runner plugins unlink [PLUGIN...] [-h] [-v]

ARGUMENTS
  PLUGIN...  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ mcp-runner plugins unlink
  $ mcp-runner plugins remove

EXAMPLES
  $ mcp-runner plugins unlink myplugin

mcp-runner plugins update

Update installed plugins.

USAGE
  $ mcp-runner plugins update [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Update installed plugins.

See code: @oclif/plugin-plugins

mcp-runner run [PACKAGE]

Run a mcp server package

USAGE
  $ mcp-runner run [PACKAGE]

ARGUMENTS
  PACKAGE  package to run

DESCRIPTION
  Run a mcp server package

EXAMPLES
  $ mcp-runner run <package-name>

See code: src/commands/run.ts