Discover / Development
MCP CLI
by wong2JavaScript
CLI inspector and debugger for the Model Context Protocol.
Toolexperimental
Maturity: experimental because active but has never tagged a release. Derived from release and commit history, not a rating.
- Stars
- 443
- Forks
- 41
- Downloads / mo
- —
- Last commit
- 2026-06-08
- License
- GPL-3.0
- Open issues
- 11
Market and trust evidence
Edition not yet matchedNo exact skills.sh identity match is available for this repository. Repository adoption and freshness remain visible above; install momentum is not inferred.
Trust analysis is a screening signal, not a security warranty. Read the ranking and trust methodology.
In practice
Written by AI from this repository’s README · high confidenceProvides a CLI surface to interact with, inspect, and test Model Context Protocol servers.
Use it when
Use when developing or troubleshooting MCP servers and verifying tools, resources, and prompts.
Not the right pick when
Not needed if you are using full client integrations like Claude Desktop or Cursor.
Capabilities
- Inspect and run MCP servers
- List tools, resources, and prompts
- Call tools and read resources
- OAuth support for SSE/HTTP servers
Requirements
- Node.js
- npx
Cost: Free and open source
Video walkthroughs
Third-party YouTube uploads matched to this tool by title, channel and repository name on 2026-08-20. Not made, reviewed or endorsed by SkillPilot. View counts and publish months are as of the match date and the month is approximate. Nothing loads from YouTube until you press play.
Tags
README
mcp-cli
A CLI inspector for the Model Context Protocol
https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183
Features
- Run MCP servers from various sources
- List Tools, Resources, Prompts
- Call Tools, Read Resources, Read Prompts
- OAuth support for SSE and Streamable HTTP servers
Usage
Run without arguments
npx @wong2/mcp-cli
This will use the config file of Claude Desktop.
Run with a config file
npx @wong2/mcp-cli -c config.json
The config file has the same format as the Claude Desktop config file.
Run servers from NPM
npx @wong2/mcp-cli npx <package-name> <args>
Add --pass-env if the server needs environment variables from your current shell.
Run locally developed server
npx @wong2/mcp-cli node path/to/server/index.js args...
Add --pass-env if the server needs environment variables from your current shell.
Connect to a running server over Streamable HTTP
npx @wong2/mcp-cli --url http://localhost:8000/mcp
Connect to a running server over SSE
npx @wong2/mcp-cli --sse http://localhost:8000/sse
Non-interactive mode
Run a specific tool, resource, or prompt without interactive prompts:
npx @wong2/mcp-cli [--config config.json] <command> <server-name>:<target> [--args '{}']
Examples:
# Call a tool without arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:list_files
# Call a tool with arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:read_file --args '{"path": "package.json"}'
# Read a resource
npx @wong2/mcp-cli -c config.json read-resource filesystem:file://system/etc/hosts
# Use a prompt
npx @wong2/mcp-cli -c config.json get-prompt filesystem:create_summary --args '{"text": "Hello world"}'
This mode is useful for scripting and automation, as it bypasses all interactive prompts and executes the specified primitive directly.
Purge stored data (OAuth tokens, etc.)
npx @wong2/mcp-cli purge
Related
- mcpservers.org - A curated list of MCP servers