mcp-cli

mcp-cli

Model Context Protocol 的 CLI 检查工具

https://github.com/user-attachments/assets/4cd113e9-f097-4c9d-b391-045c5f213183

功能

• 从各种来源运行 MCP 服务
• 列出工具、资源和提示词
• 调用工具、读取资源和提示词
• 支持 SSE 和 Streamable HTTP 服务的 OAuth

用法

不带参数运行

npx @wong2/mcp-cli

这将使用 Claude Desktop 的配置文件。

使用配置文件运行

npx @wong2/mcp-cli -c config.json

配置文件的格式与 Claude Desktop 配置文件相同。

从 NPM 运行服务

npx @wong2/mcp-cli npx <package-name> <args>

如果服务需要当前 shell 中的环境变量，请添加 --pass-env。

运行本地开发的服务

npx @wong2/mcp-cli node path/to/server/index.js args...

如果服务需要当前 shell 中的环境变量，请添加 --pass-env。

通过 Streamable HTTP 连接到正在运行的服务

npx @wong2/mcp-cli --url http://localhost:8000/mcp

通过 SSE 连接到正在运行的服务

npx @wong2/mcp-cli --sse http://localhost:8000/sse

非交互模式

运行指定的工具、资源或提示词，而不显示交互式提示：

npx @wong2/mcp-cli [--config config.json] <command> <server-name>:<target> [--args '{}']

示例：

# Call a tool without arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:list_files

# Call a tool with arguments
npx @wong2/mcp-cli -c config.json call-tool filesystem:read_file --args '{"path": "package.json"}'

# Read a resource
npx @wong2/mcp-cli -c config.json read-resource filesystem:file://system/etc/hosts

# Use a prompt
npx @wong2/mcp-cli -c config.json get-prompt filesystem:create_summary --args '{"text": "Hello world"}'

此模式适用于脚本编写和自动化，因为它会跳过所有交互式提示，并直接执行指定的原语。

清除存储的数据（OAuth 令牌等）

npx @wong2/mcp-cli purge

相关项目

• mcpservers.org - 精选的 MCP 服务列表