mcpField
M
mcp-cli

mcp-cli

github.com/githubAgent 工作流40.5k9.7k 次安装今天更新
代码仓库

关于 mcp-cli

mcp-cli 是用于发现和调用已配置 MCP 服务工具的命令行技能，支持查看工具参数与 JSON Schema、执行调用，并选择适合脚本的输出格式。

主要功能

  1. 01列出服务和工具名称
  2. 02查看工具参数与 JSON Schema
  3. 03传入参数调用工具
  4. 04按名称搜索工具
  5. 05支持 JSON 和原始文本输出

适用场景

  1. 01查找已配置服务中的工具
  2. 02调用前核对工具输入 Schema
  3. 03通过命令行运行 MCP 工具
  4. 04在脚本中使用 JSON 输出

MCP 相关

该命令行客户端可访问 MCP 服务、列出工具、检查 Schema 并执行工具调用。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/github/awesome-copilot --skill mcp-cli

安装后在 Claude Code 中输入/mcp-cli确认已加载。

详细介绍

MCP-CLI

通过命令行访问 MCP 服务。MCP 支持与 GitHub、文件系统、数据库和 API 等外部系统交互。

命令

命令输出
mcp-cli列出所有服务和工具名称
mcp-cli <server>显示工具及其参数
mcp-cli <server>/<tool>获取工具 JSON schema
mcp-cli <server>/<tool> '<json>'使用参数调用工具
mcp-cli grep "<glob>"按名称搜索工具

添加 -d 以包含描述（例如 mcp-cli filesystem -d）

工作流

  1. 发现：mcp-cli → 查看可用的服务和工具
  2. 探索：mcp-cli <server> → 查看工具及其参数
  3. 检查：mcp-cli <server>/<tool> → 获取完整的 JSON 输入 schema
  4. 执行：mcp-cli <server>/<tool> '<json>' → 使用参数运行

示例

# 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\": \"{}\"}"'

选项

标志用途
-j, --json用于脚本的 JSON 输出
-r, --raw原始文本内容
-d包含描述

退出码

  • 0：成功
  • 1：客户端错误（参数错误、缺少配置）
  • 2：服务错误（工具执行失败）
  • 3：网络错误

评论

支持 Markdown