← 返回目录

MCP CLI

社区

非标准 Server

轻量级命令行工具，用于与 MCP 服务器交互。

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 60 / 438
Stars: ★ 1.3k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Bun 1.0.0+ · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 8 个月前 ⚠
工具数: 3

64FMRS · C

mcp-cli 是一个功能丰富的 CLI 工具，特别适合 AI 代理和终端用户，它以脚本友好方式提供对 MCP 服务器的访问。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

14/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 静态审查仅基于README，未提供实际源码。README描述了丰富的CLI功能，并宣称有单元测试和集成测试，但无具体证据。不确定性降低评分，故给10分。
安全与权限 12/20: README提到环境变量替换、工具过滤和清晰的错误提示，但缺少危险操作确认、数据流披露和具体安全测试。未发现明显红线风险，但权限确认不明确，故给12分。
维护活跃度 14/20: 仓库有MIT许可证、大量stars和持续更新迹象，但未提供发布频率、issue响应时间或依赖更新策略的具体证据。未发现安全响应渠道，故给14分。
文档质量 15/20: README非常详细，覆盖安装、配置、用法、错误处理和开发指南，但缺少故障排查和限制披露。文档质量高但未达到满分，故给15分。
安装易用性 13/20: 安装步骤清晰（curl或bun），但依赖Bun运行时，且未提供主流客户端的具体配置示例。静态证据不足，未超过15分上限，故给13分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

希望以微创方式集成 MCP 服务器的 AI 编码代理。
需要在终端中直接操作 MCP 工具的开发者。
需要高效、可脚本化访问 MCP 工具的用户。

不适合谁

需要图形界面的用户。
不使用 MCP 协议的场景。
需要持久连接或重型会话管理的场景（CLI 设计为一次性请求）。

所需权限

读取和写入配置文件中指定的 MCP 服务器配置。
通过 stdio 启动子进程（如 npx）。
建立网络连接以访问远程 MCP 服务器（如果配置）。
创建临时 Unix 套接字用于连接池（默认启用守护进程模式）。

风险与副作用

配置中的敏感信息（如 API 密钥）可能以明文存储。
启动的 MCP 服务器可能执行任意命令，尤其是从不可信来源安装时。
连接保持活动可能导致资源占用，如果长时间不活动。
使用 npm/npx 包作为服务器命令时，存在供应链风险。

安装接入

准备工作

运行环境：Bun 1.0.0+ · 预编译二进制

其他可选配置项（9 个）

MCP_CONFIG_PATH 可选指定配置文件路径，默认按内置顺序搜索 mcp_servers.

MCP_DEBUG 可选设为 1 开启调试输出（含 daemon 调试）

MCP_TIMEOUT 可选单次请求超时秒数，默认 1800

MCP_CONCURRENCY 可选并行处理的服务器数量，默认 5

MCP_MAX_RETRIES 可选瞬时错误的重试次数，默认 3，0 为禁用

MCP_RETRY_DELAY 可选重试基础延迟毫秒数，默认 1000

MCP_STRICT_ENV 可选默认 true，配置中缺失环境变量时报错；设为 false 改用空值

MCP_NO_DAEMON 可选设为 1 禁用连接缓存，强制新建连接

MCP_DAEMON_TIMEOUT 可选缓存连接的空闲超时秒数，默认 60

安装：curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash 或 bun install -g https://github.com/philschmid/mcp-cli。
创建配置文件 mcp_servers.json（见上图）。
使用 mcp-cli 命令。

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "."
      ]
    },
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "."
      ]
    },
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
claude mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后运行 `mcp-cli`（或 `mcp-cli -d`），输出中应出现配置里 servers（如 filesystem、deepwiki）及其工具列表，说明连接成功。

常见排障

检查配置文件路径是否正确（`mcp_servers.json` 或 `~/.config/mcp/`）。
设置 `MCP_DEBUG=1` 查看调试输出。
设置 `MCP_NO_DAEMON=1` 禁用连接缓存，解决连接问题。
确保服务器命令可用（如 `npx` 已安装）。
验证环境变量替换（`${VAR}`）是否满足 `MCP_STRICT_ENV` 要求。
参考错误消息中的恢复建议。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出所有已配置的 MCP 服务器及其工具
查看 filesystem 服务器的 read_file 工具的参数 schema
用 mcp-cli 调用 filesystem 的 read_file 读取 README.md
用 glob 模式 grep 搜索所有包含 file 的工具

工具能力 3

info 只读

显示服务器信息、可用工具和模式。

grep 只读

按 glob 模式搜索工具。

call

调用服务器上的工具，支持内联 JSON 或从 stdin 读取。

使用场景

在命令行中快速列出和调用 MCP 工具。

为 AI 编码代理（如 Gemini CLI、Claude Code）提供 MCP 服务器的命令行接口。

在 shell 脚本中通过管道与 jq 等工具组合使用 MCP 工具。

支持客户端

Claude Desktop部分支持

Gemini CLI部分支持

OpenCode部分支持

Claude Code部分支持

依据项目文档列出，未经本站实测。

详细介绍

mcp-cli 是一个基于 Bun 的轻量级 CLI，用于与 Model Context Protocol (MCP) 服务器交互。它支持通过 stdio 和 HTTP 传输的服务器，提供工具发现、模式查看、调用等功能，并优化了 AI 编程代理的使用体验。