https://github.com/wong2/mcp-cli
A CLI inspector for the Model Context Protocol
https://github.com/wong2/mcp-cli
Last synced: 29 days ago
JSON representation
A CLI inspector for the Model Context Protocol
- Host: GitHub
- URL: https://github.com/wong2/mcp-cli
- Owner: wong2
- License: gpl-3.0
- Created: 2024-12-05T04:21:46.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-12T07:04:56.000Z (2 months ago)
- Last Synced: 2025-04-05T16:22:28.833Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 2.56 MB
- Stars: 210
- Watchers: 3
- Forks: 17
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - mcp-cli - Command-line exploration tool for MCP servers (🔌 Integration Tools / Clients & Interfaces)
- awesome-mcp-servers - mcp-cli - Command-line exploration tool for MCP servers (🔌 Integration Tools / Clients & Interfaces)
- awesome-mcp-zh - wong2/mcp-cli
- awesome-mcp-servers - wong2/mcp-cli - CLI tool for testing MCP servers (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - wong2/mcp-cli - CLI tool for testing MCP servers (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - mcp-cli
- Awesome-MCP-Servers-directory - mcp-cli - A CLI inspector for MCP servers (Command Line)
- awesome-mcp-servers - MCP CLI Inspector - A CLI inspector for the Model Context Protocol (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - MCP CLI Inspector - A CLI inspector for the Model Context Protocol (Table of Contents / Other Tools and Integrations)
- awesome-mcp-devtools - wong2/mcp-cli - Command line inspector for manual testing (Testing Tools / Dart)
- awesome-mcp-devtools - wong2/mcp-cli - Command line inspector for manual testing (Testing Tools / Dart)
README
# mcp-cli
A CLI inspector for the Model Context Protocol
https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183
## Usage
### Run without config file
```bash
npx @wong2/mcp-cli
```
This will use the config file of Claude Desktop.
### Run with a config file
```bash
npx @wong2/mcp-cli -c config.json
```
The config file has the same format as the Claude Desktop config file.
### Run servers from NPM
```bash
npx @wong2/mcp-cli npx
```
### Run locally developed server
```bash
npx @wong2/mcp-cli node path/to/server/index.js args...
```
### Connect to a running server over SSE
```bash
npx @wong2/mcp-cli --sse http://localhost:8000/sse
```
You need to first start an MCP server running over [SSE transport](https://modelcontextprotocol.io/docs/concepts/transports#server-sent-events-sse).
## Features
- Run MCP servers from various sources
- List Tools, Resources, Prompts
- Call Tools, Read Resources, Read Prompts
## Related
- [LiteMCP](https://github.com/wong2/litemcp) - A TypeScript library that simplifies MCP server development
- [mcpservers.org](https://mcpservers.org) - A curated list of MCP servers