mirror of
https://github.com/github/awesome-copilot.git
synced 2026-02-20 02:15:12 +00:00
Add 8 new skills for development tools and workflows
This PR adds the following skills: - azure-devops-cli: Azure DevOps operations via CLI - chrome-devtools: Browser automation and debugging - gh-cli: GitHub CLI comprehensive reference - git-commit: Smart git commit with conventional commits - mcp-cli: Model Context Protocol server interface - plantuml-ascii: ASCII diagram generation - prd: Product Requirements Document generation - refactor: Surgical code refactoring guidance All skills follow the project conventions with proper SKILL.md frontmatter.
This commit is contained in:
78
skills/mcp-cli/SKILL.md
Normal file
78
skills/mcp-cli/SKILL.md
Normal file
@@ -0,0 +1,78 @@
|
||||
---
|
||||
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.
|
||||
---
|
||||
|
||||
# MCP-CLI
|
||||
|
||||
Access MCP servers through the command line. MCP enables interaction with external systems like GitHub, filesystems, databases, and APIs.
|
||||
|
||||
## Commands
|
||||
|
||||
| Command | Output |
|
||||
| ---------------------------------- | ------------------------------- |
|
||||
| `mcp-cli` | List all servers and tool names |
|
||||
| `mcp-cli <server>` | Show tools with parameters |
|
||||
| `mcp-cli <server>/<tool>` | Get tool JSON schema |
|
||||
| `mcp-cli <server>/<tool> '<json>'` | Call tool with arguments |
|
||||
| `mcp-cli grep "<glob>"` | Search tools by name |
|
||||
|
||||
**Add `-d` to include descriptions** (e.g., `mcp-cli filesystem -d`)
|
||||
|
||||
## Workflow
|
||||
|
||||
1. **Discover**: `mcp-cli` → see available servers and tools
|
||||
2. **Explore**: `mcp-cli <server>` → see tools with parameters
|
||||
3. **Inspect**: `mcp-cli <server>/<tool>` → get full JSON input schema
|
||||
4. **Execute**: `mcp-cli <server>/<tool> '<json>'` → run with arguments
|
||||
|
||||
## Examples
|
||||
|
||||
```bash
|
||||
# List all servers and tool names
|
||||
mcp-cli
|
||||
|
||||
# See all tools with parameters
|
||||
mcp-cli filesystem
|
||||
|
||||
# With descriptions (more verbose)
|
||||
mcp-cli filesystem -d
|
||||
|
||||
# Get JSON schema for specific tool
|
||||
mcp-cli filesystem/read_file
|
||||
|
||||
# Call the tool
|
||||
mcp-cli 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
|
||||
|
||||
# Complex JSON with quotes (use heredoc or stdin)
|
||||
mcp-cli server/tool <<EOF
|
||||
{"content": "Text with 'quotes' inside"}
|
||||
EOF
|
||||
|
||||
# Or pipe from a file/command
|
||||
cat args.json | mcp-cli server/tool
|
||||
|
||||
# Find all TypeScript files and read the first one
|
||||
mcp-cli filesystem/search_files '{"path": "src/", "pattern": "*.ts"}' --json | jq -r '.content[0].text' | head -1 | xargs -I {} sh -c 'mcp-cli filesystem/read_file "{\"path\": \"{}\"}"'
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
| Flag | Purpose |
|
||||
| ------------ | ------------------------- |
|
||||
| `-j, --json` | JSON output for scripting |
|
||||
| `-r, --raw` | Raw text content |
|
||||
| `-d` | Include descriptions |
|
||||
|
||||
## Exit Codes
|
||||
|
||||
- `0`: Success
|
||||
- `1`: Client error (bad args, missing config)
|
||||
- `2`: Server error (tool failed)
|
||||
- `3`: Network error
|
||||
Reference in New Issue
Block a user