From e36ef0cf3105db76ddd0f1bb66bc1de33f36880e Mon Sep 17 00:00:00 2001 From: Aung Myo Kyaw Date: Thu, 29 Jan 2026 01:05:19 +0700 Subject: [PATCH 1/2] fix: correct mcp-cli skill command syntax and add installation guide - Add homepage field to skill frontmatter - Add Prerequisites section with installation instructions - Add configuration example for mcp_servers.json - Fix command syntax: add missing 'info' and 'call' subcommands - Update all examples to use correct 'mcp-cli info' and 'mcp-cli call' syntax - Clarify that both space and / separator formats work - Update workflow section with correct commands Fixes issue where mcp-cli SKILL.md had inaccurate command syntax and was missing installation/source information. --- skills/mcp-cli/SKILL.md | 79 +++++++++++++++++++++++++++++++---------- 1 file changed, 60 insertions(+), 19 deletions(-) diff --git a/skills/mcp-cli/SKILL.md b/skills/mcp-cli/SKILL.md index d5b801ee..3e85321e 100644 --- a/skills/mcp-cli/SKILL.md +++ b/skills/mcp-cli/SKILL.md @@ -1,30 +1,71 @@ --- name: mcp-cli description: Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line. +homepage: https://github.com/philschmid/mcp-cli --- # MCP-CLI Access MCP servers through the command line. MCP enables interaction with external systems like GitHub, filesystems, databases, and APIs. +**Homepage:** https://github.com/philschmid/mcp-cli + +## Prerequisites + +### Installation + +```bash +# Quick install (recommended) +curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash + +# Or install with Bun (requires Bun) +bun install -g https://github.com/philschmid/mcp-cli + +# Verify installation +mcp-cli --version +``` + +### Configuration + +Create `mcp_servers.json` in your current directory or `~/.config/mcp/`: + +```json +{ + "mcpServers": { + "filesystem": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] + }, + "github": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-github"] + } + } +} +``` + +**Documentation:** https://github.com/philschmid/mcp-cli + ## Commands -| Command | Output | -| ---------------------------------- | ------------------------------- | -| `mcp-cli` | List all servers and tool names | -| `mcp-cli ` | Show tools with parameters | -| `mcp-cli /` | Get tool JSON schema | -| `mcp-cli / ''` | Call tool with arguments | -| `mcp-cli grep ""` | Search tools by name | +| Command | Output | +| --------------------------------------- | ------------------------------- | +| `mcp-cli` | List all servers and tool names | +| `mcp-cli info ` | Show tools with parameters | +| `mcp-cli info ` | Get tool JSON schema | +| `mcp-cli call ''` | Call tool with arguments | +| `mcp-cli grep ""` | Search tools by name | + +**Both formats work:** `info ` or `info /` -**Add `-d` to include descriptions** (e.g., `mcp-cli filesystem -d`) +**Add `-d` to include descriptions** (e.g., `mcp-cli info filesystem -d`) ## Workflow 1. **Discover**: `mcp-cli` → see available servers and tools -2. **Explore**: `mcp-cli ` → see tools with parameters -3. **Inspect**: `mcp-cli /` → get full JSON input schema -4. **Execute**: `mcp-cli / ''` → run with arguments +2. **Explore**: `mcp-cli info ` → see tools with parameters +3. **Inspect**: `mcp-cli info ` → get full JSON input schema +4. **Execute**: `mcp-cli call ''` → run with arguments ## Examples @@ -33,33 +74,33 @@ Access MCP servers through the command line. MCP enables interaction with extern mcp-cli # See all tools with parameters -mcp-cli filesystem +mcp-cli info filesystem # With descriptions (more verbose) -mcp-cli filesystem -d +mcp-cli info filesystem -d # Get JSON schema for specific tool -mcp-cli filesystem/read_file +mcp-cli info filesystem read_file # Call the tool -mcp-cli filesystem/read_file '{"path": "./README.md"}' +mcp-cli call filesystem read_file '{"path": "./README.md"}' # Search for tools mcp-cli grep "*file*" # JSON output for parsing -mcp-cli filesystem/read_file '{"path": "./README.md"}' --json +mcp-cli call filesystem read_file '{"path": "./README.md"}' -j # Complex JSON with quotes (use heredoc or stdin) -mcp-cli server/tool < Date: Thu, 29 Jan 2026 18:37:45 +0700 Subject: [PATCH 2/2] Update skills/mcp-cli/SKILL.md Co-authored-by: Aaron Powell --- skills/mcp-cli/SKILL.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/skills/mcp-cli/SKILL.md b/skills/mcp-cli/SKILL.md index 3e85321e..57eab286 100644 --- a/skills/mcp-cli/SKILL.md +++ b/skills/mcp-cli/SKILL.md @@ -1,7 +1,8 @@ --- name: mcp-cli description: Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line. -homepage: https://github.com/philschmid/mcp-cli +metadata + homepage: https://github.com/philschmid/mcp-cli --- # MCP-CLI