Log inSubmit server
MCP Cli logo

MCP Cli

by wong2

Inspect, connect to, and invoke MCP servers from an interactive or scriptable command-line interface.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Cli

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
Server URL
http://localhost:8000/mcp

Remote servers are added in the app, not the config file: Customize → Connectors → Add custom connector, then paste this URL.

Overview

The wong2/mcp-cli MCP server provides a command-line inspector for Model Context Protocol servers. It can launch servers from npm packages or local commands, load Claude Desktop-style configuration, and connect to Streamable HTTP or SSE endpoints. Use it to inspect tools, resources, and prompts, invoke them interactively, or run direct commands for scripting and automation.

Use cases

  • Inspect an MCP server's tools, resources, and prompts
  • Launch an npm-based MCP server for testing
  • Connect to a local HTTP or SSE MCP endpoint
  • Call MCP primitives from shell automation
  • Purge stored OAuth data

Key features

  • Interactive MCP primitive inspection
  • Non-interactive tool, resource, and prompt execution
  • npm and local Node.js server launching
  • Streamable HTTP and SSE connections
  • OAuth support for remote transports
  • Claude Desktop-compatible configuration

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/8 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 1

Scanned 8/17/2026 via OSV.dev · http://localhost:8000/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars447Stargazers on the source repository.
Last commit4mo agoMost recent push to the default branch.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Cli works

What wong2/mcp-cli MCP server does

The wong2/mcp-cli MCP server is a command-line interface for examining and using MCP servers. It exposes the protocol primitives that a developer typically needs to inspect: tools, resources, and prompts. From the CLI, you can list those primitives, call tools, read resources, and retrieve prompts.

The tool is useful when you need to verify an MCP server independently of a full host application, investigate what a server exposes, or exercise one operation from a shell script. It can also act as a client for servers started locally or already running elsewhere.

How it works

The wong2/mcp-cli MCP server accepts several ways to identify an MCP server:

  • With no arguments, it reads the Claude Desktop configuration.
  • With -c, it reads a supplied configuration file using the same format.
  • With npx, it starts an npm-based server and passes command arguments through.
  • With node, it starts a locally developed JavaScript server.
  • With --url, it connects to a Streamable HTTP endpoint.
  • With --sse, it connects to an SSE endpoint.

Interactive use lets you browse the available primitives. Non-interactive commands address a target using the form <server-name>:<target>, making direct invocation suitable for automation. Tool and prompt arguments can be supplied as JSON with --args.

Setup and configuration

Run the CLI through npx:

Terminal
npx @wong2/mcp-cli

To use a specific configuration file, provide its path:

Terminal
npx @wong2/mcp-cli -c config.json

When launching an npm package or local server, add --pass-env if that process needs environment variables from the current shell. HTTP and SSE connections are configured by passing the relevant endpoint URL on the command line. Stored data, including OAuth tokens, can be removed with the purge command.

Tools and capabilities

The wong2/mcp-cli MCP server supports these operations:

  • List tools, resources, and prompts.
  • Call a named tool, with optional JSON arguments.
  • Read a named resource.
  • Retrieve a prompt, with optional JSON arguments.
  • Start MCP servers from npm packages or local Node.js files.
  • Connect to Streamable HTTP and SSE servers.
  • Use OAuth with SSE and Streamable HTTP servers.
  • Run commands interactively or without prompts.

Limitations and notes

The CLI is an inspector and client for MCP servers, not a directory of server implementations. Its configuration format follows Claude Desktop's format, and the README specifically documents use with Claude Desktop configuration. Environment variables are not declared by the CLI itself; --pass-env forwards variables from the invoking shell to a launched server when needed. The documented examples use Node.js-oriented commands and npx.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Cli

wong2/mcp-cli is an MCP server that provides a command-line client and inspector for connecting to MCP servers. It can launch npm or local Node.js servers, connect over Streamable HTTP or SSE, list tools, resources, and prompts, and call tools, read resources, or retrieve prompts.

Run it with npx rather than installing a separate package: `npx @wong2/mcp-cli`. You can start it with no arguments, point it at a Claude Desktop-style configuration using `-c config.json`, or pass a server command or remote endpoint.

Use the `--sse` option followed by the endpoint URL, such as `npx @wong2/mcp-cli --sse http://localhost:8000/sse`. The CLI also supports Streamable HTTP endpoints through the `--url` option.

Use the non-interactive `call-tool` command with a server and tool target, then add JSON through `--args` when required. For example, `call-tool filesystem:read_file --args '{"path":"package.json"}'` invokes the named tool without interactive prompts.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Cli AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/wong2-mcp-cli?style=directory)](https://allmcps.com/mcp/wong2-mcp-cli)
HTML Embed
<a href="https://allmcps.com/mcp/wong2-mcp-cli"><img src="https://allmcps.com/api/badge/wong2-mcp-cli?style=directory" alt="MCP Cli on AllMCPs" /></a>