MCP协议CLI检查器

用于Model Context Protocol的命令行检查工具,支持运行MCP服务器、调用工具、读取资源和提示等功能。

  • by wong2
  • JavaScript
  • 混合部署
  • 447 星标
  • 更新于
在 GitHub 查看 wong2/mcp-cli

使用说明

mcp-cli

模型上下文协议的CLI检查器

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

特性

  • 从各种来源运行MCP服务器
  • 列出工具、资源、提示
  • 调用工具、阅读资源、阅读提示
  • OAuth支持SSE和流式HTTP服务器

用法

无争议地运行

npx @wong2/mcp-cli

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

使用配置文件运行

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

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

从NPM运行服务器

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

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

运行本地开发的服务器

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

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

通过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

相关