Skip to main content
Glama
cli-mcp
by mlaugharn

cli MCP server

cli bridge

Pretty much a remix of the demo notes app.

Components

Resources

The server implements a simple system for working with arbitrary clis with:

  • Custom cli:// URI scheme for accessing individual notes

  • Each cli resource has a name, help menu subtree, and text/plain mimetype

Tools

The server implements one tool:

  • add (cmd): Recursively parses cli help menu subtrees and stores definition

    • Takes "cmd"

    • Updates server state and notifies clients of resource changes

  • help (cmd): Return subtrees definition

  • run (cmd, cmd_args | None): Run a known command

Related MCP server: PyCLI MCP

Quickstart

Install

Claude Desktop

Note: I had to use /opt/homebrew/bin/uv instead of just uv in the command field in this json:

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

{"mcpServers": {
  "cli": {
    "command": "uv",
    "args": [
      "run",
      "--directory",
      "\<path to repo folder\>",
      "cli"
    ]}
  }
}

By design, you have to explicitly 'add' a command before it can be run.

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory <path to repo> run cli

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Available Tools

3 tools
addC

Add a new cli schema learned by traversing parsing all help menu subtrees.

Inputs: cmd (required).

helpC

Returns learned schema of cli.

Inputs: cmd (required).

runC

Run a command

Inputs: cmd (required), cmd_args.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: add learns a CLI schema, help retrieves it, and run executes a command. There is no overlap.

    Naming Consistency5/5

    All tool names are single imperative verbs (add, help, run), following a consistent pattern.

    Tool Count5/5

    Three tools is appropriate for a focused CLI schema management server, covering learning, retrieval, and execution.

    Completeness3/5

    Basic lifecycle is covered (add, retrieve, run), but lacks schema update or deletion, and may not support multiple CLIs.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables natural language interaction with any Python CLI application (Click, Typer, Argparse) through the Model Context Protocol.
      22
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to call any CLI tool by scanning its help output and serving it as an MCP server.
      1
      GPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Universal MCP server that wraps any CLI tool, enabling AI assistants to run commands via natural language.
      1
      MIT