AI导哈

MCP命令行工具

一个零依赖的命令行工具，用于与Model Context Protocol (MCP)服务器交互，支持标准输入输出和HTTP传输，适用于测试、调试和集成MCP服务器。

  • by joshbeckman
  • Ruby
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 joshbeckman/mcp_cli

使用说明

MCP-CLI

用于与交互的零依赖命令行界面 模型上下文协议（MCP） 服务器。MCP使AI助手能够通过标准化协议安全地连接到本地和远程资源。

非常适合需要以下功能的开发人员：

  • 测试MCP服务器实现
  • 调试服务器响应
  • 将MCP服务器集成到脚本和工作流中
  • 探索可用的工具和资源

支持stdio和HTTP传输，并具有自动配置发现功能。

需求

  • Ruby 2.7或更高版本
  • RubyGems 3.0或更高版本
  • 与macOS、Linux和Windows兼容

快速启动（无需安装）

使用MCP CLI的最快方法是 gem exec -无需安装：

gem exec mcp_cli list
gem exec mcp_cli tools my-server
gem exec --silent mcp_cli call my-server my-tool --arg value | grep "foobar"

这非常适合在不添加依赖项的情况下试用该工具或在脚本中使用它。 gem exec 支持快速软件.

安装（可选）

如果你更喜欢安装gem：

gem install mcp_cli

然后直接使用它：

mcp list
mcp tools my-server

配置

MCP CLI在以下位置查找服务器配置（按顺序）：

  1. ~/.claude.json
  2. ~/.cursor/mcp.json
  3. ~/.vscode/mcp.json

您还可以指定自定义配置文件：

gem exec mcp_cli --mcp-config /path/to/config.json list

或者使用默认配置的快捷方式：

gem exec mcp_cli --mcp-config claude list
gem exec mcp_cli --mcp-config cursor list
gem exec mcp_cli --mcp-config vscode list

配置格式

您的配置文件应遵循以下结构：

{
  "mcpServers": {
    "my-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/server.js"],
      "env": {
        "API_KEY": "your-key"
      }
    },
    "http-server": {
      "type": "http",
      "url": "https://example.com/mcp",
      "headers": {
        "Authorization": "Bearer token"
      }
    }
  }
}

用法

列出可用服务器

gem exec mcp_cli list

列出工具

# List all tools on a server
gem exec mcp_cli tools my-server

# Show details for a specific tool
gem exec mcp_cli tools my-server search_all

调用工具

# With JSON arguments
gem exec mcp_cli call my-server search_all '{"query": "example"}'

# With flag-style arguments
gem exec mcp_cli call my-server search_all --query example

# Boolean flags
gem exec mcp_cli call my-server sync --force

列表提示

gem exec mcp_cli prompts my-server

获得提示

gem exec mcp_cli prompt my-server explain '{"topic": "MCP servers"}'

列出资源

gem exec mcp_cli resources my-server

服务器信息

# Full server info
gem exec mcp_cli info my-server

# Just the version
gem exec mcp_cli version my-server

# Show configuration
gem exec mcp_cli config my-server

选项

# Use a specific protocol version
gem exec mcp_cli --protocol-version 2025-06-18 tools my-server

# Use a custom config file
gem exec mcp_cli --mcp-config /path/to/config.json list

# Show help
gem exec mcp_cli --help

# Show version
gem exec mcp_cli --version

特性

  • 零依赖 -仅使用Ruby标准库
  • 快速启动 -快速命令的开销最小
  • 灵活的论点 -支持JSON和标志样式参数
  • 多个传输 -适用于stdio和HTTP MCP服务器
  • 配置自动发现 -查找您现有的MCP配置

故障排除

服务器未找到

确保您的服务器名称与配置文件中的名称完全匹配。服务器名称区分大小写。

连接超时

对于stdio服务器，请验证命令路径是否存在以及是否可执行。检查是否安装了所有必需的依赖项。

身份验证错误

检查您的配置中是否正确设置了环境变量和标头。对于HTTP服务器，请确保您的身份验证令牌有效。

未找到配置文件

MCP CLI在中查找配置 ~/.claude.json, ~/.cursor/mcp.json，或 ~/.vscode/mcp.json。创建这些文件之一或指定自定义路径 --mcp-config.

发展

# Clone the repo
git clone https://github.com/joshbeckman/mcp_cli.git
cd mcp_cli

# Install dependencies (just development tools)
bundle install

# Run tests
bundle exec rspec

# Test locally without installing
ruby -Ilib exe/mcp list

许可证

麻省理工学院

贡献

欢迎在GitHub上提交Bug报告和拉取请求https://github.com/joshbeckman/mcp_cli.

相关 MCP