使用说明

项目简介

Gemini CLI 扩展 MCP 服务器项目是在 Gemini CLI 命令行工具的基础上，集成了两个内置的 MCP 服务器：文件系统 MCP 服务器 和 命令执行 MCP 服务器。这些服务器允许 Gemini CLI 作为一个 MCP 客户端，通过 Model Context Protocol (MCP) 协议与自身内置的服务器通信，从而扩展 Gemini 模型的上下文感知和功能执行能力。用户可以通过自然语言指令，让 Gemini 模型访问本地文件系统、执行系统命令，实现更丰富的交互体验。

主要功能点

内置 MCP 服务器: 集成文件系统和命令执行 MCP 服务器，无需额外安装和配置。
文件系统访问: 文件系统 MCP 服务器提供文件和目录的浏览、读取等操作，让 Gemini 模型能够理解和操作本地文件。
命令执行: 命令执行 MCP 服务器允许 Gemini 模型执行 Linux 系统命令，方便用户通过自然语言控制系统操作。
用户确认: 执行任何工具操作（如文件操作、命令执行）前，都需要用户确认，保障安全性。
易于安装和使用: 通过简单的安装脚本即可部署 Gemini CLI 和内置 MCP 服务器。

安装步骤

克隆仓库

git clone https://github.com/frostdev-ops/gemini-cli
cd gemini-cli

运行安装脚本
```
./install.sh
```
安装脚本会自动编译 Gemini CLI，并安装 'gemini' 命令行工具以及内置的 MCP 服务器。
重载 Shell 配置

安装脚本会修改你的 Shell 配置文件（如 '~/.bashrc' 或 '~/.zshrc'），你需要重载配置文件才能使 'gemini' 命令生效。
```
source ~/.zshrc  # 或 source ~/.bashrc
```

服务器配置

内置的 MCP 服务器（文件系统和命令执行）无需手动配置，安装脚本会自动完成配置。

Gemini CLI 客户端的 MCP 服务器配置信息 ( '~/.config/gemini-cli/mcp_servers.json' ) 如下：

[
  {
    "name": "filesystem",  // 服务器名称，用于客户端识别
    "enabled": true,     // 启用该服务器
    "transport": "stdio",  // 使用 stdio 传输协议
    "command": ["~/.local/bin/mcp-servers/filesystem-mcp"], // 文件系统 MCP 服务器启动命令
    "args": []            // 启动参数，此处为空
  },
  {
    "name": "command",     // 服务器名称，用于客户端识别
    "enabled": true,      // 启用该服务器
    "transport": "stdio",  // 使用 stdio 传输协议
    "command": ["~/.local/bin/mcp-servers/command-mcp"],   // 命令执行 MCP 服务器启动命令
    "args": []            // 启动参数，此处为空
  }
]

参数注释:

name: MCP 服务器的唯一名称，客户端通过此名称来引用服务器。
enabled: 布尔值，指示服务器是否启用。'true' 表示启用，'false' 表示禁用。
transport: 指定 MCP 服务器使用的传输协议，'stdio' 表示使用标准输入输出流进行通信。
command: 一个字符串数组，用于指定启动 MCP 服务器进程的命令。第一个元素是可执行文件的路径，后续元素是命令行参数。
args: 一个字符串数组，用于向 'command' 指定的可执行文件传递额外的命令行参数。

注意： 用户无需手动修改此配置文件，内置 MCP 服务器已自动配置完成。此配置信息仅供参考，帮助用户理解 MCP 客户端如何与 MCP 服务器建立连接。

基本使用方法

设置 Gemini API Key

首次使用需要设置 Gemini API Key。

gemini --set-api-key YOUR_API_KEY_HERE

与 Gemini 模型对话

直接使用 'gemini' 命令加上你的问题即可与 Gemini 模型对话。

gemini "列出当前目录下所有的 Python 文件"
gemini "查看磁盘使用情况"

对于需要访问文件系统或执行命令的请求，Gemini 模型会通过 MCP 协议调用内置的 MCP 服务器，并在执行前请求用户确认。

关键词

命令行工具, 智能助手, 功能扩展, 文件管理, 系统控制