Skip to content
Back to search

mcp-cli

A CLI inspector for the Model Context Protocol

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wong2--mcp-cli/badge.svg)](/listings/wong2--mcp-cli)

HTML

<a href="/listings/wong2--mcp-cli"><img src="/api/listings/wong2--mcp-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 94 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mcp-cli
  2. A CLI inspector for the Model Context Protocol
  3. https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183
  4. ## Features
  5. - Run MCP servers from various sources
  6. - List Tools, Resources, Prompts
  7. - Call Tools, Read Resources, Read Prompts
  8. - OAuth support for SSE and Streamable HTTP servers
  9. ## Usage
  10. ### Run without arguments
  11. ```bash
  12. npx @wong2/mcp-cli
  13. ```
  14. This will use the config file of Claude Desktop.
  15. ### Run with a config file
  16. ```bash
  17. npx @wong2/mcp-cli -c config.json
  18. ```
  19. The config file has the same format as the Claude Desktop config file.
  20. ### Run servers from NPM
  21. ```bash
  22. npx @wong2/mcp-cli npx <package-name> <args>
  23. ```
  24. Add `--pass-env` if the server needs environment variables from your current shell.
  25. ### Run locally developed server
  26. ```bash
  27. npx @wong2/mcp-cli node path/to/server/index.js args...
  28. ```
  29. Add `--pass-env` if the server needs environment variables from your current shell.
  30. ### Connect to a running server over Streamable HTTP
  31. ```bash
  32. npx @wong2/mcp-cli --url http://localhost:8000/mcp
  33. ```
  34. ### Connect to a running server over SSE
  35. ```bash
  36. npx @wong2/mcp-cli --sse http://localhost:8000/sse
  37. ```
  38. ### Non-interactive mode
  39. Run a specific tool, resource, or prompt without interactive prompts:
  40. ```bash
  41. npx @wong2/mcp-cli [--config config.json] <command> <server-name>:<target> [--args '{}']
  42. ```
  43. Examples:
  44. ```bash
  45. # Call a tool without arguments
  46. npx @wong2/mcp-cli -c config.json call-tool filesystem:list_files
  47. # Call a tool with arguments
  48. npx @wong2/mcp-cli -c config.json call-tool filesystem:read_file --args '{"path": "package.json"}'
  49. # Read a resource
  50. npx @wong2/mcp-cli -c config.json read-resource filesystem:file://system/etc/hosts
  51. # Use a prompt
  52. npx @wong2/mcp-cli -c config.json get-prompt filesystem:create_summary --args '{"text": "Hello world"}'
  53. ```
  54. This mode is useful for scripting and automation, as it bypasses all interactive prompts and executes the specified primitive directly.
  55. ### Purge stored data (OAuth tokens, etc.)
  56. ```bash
  57. npx @wong2/mcp-cli purge
  58. ```
  59. ## Related
  60. - [mcpservers.org](https://mcpservers.org) - A curated list of MCP servers

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.