← 返回目录

Gemini CLI

社区

非标准 Server

在终端中使用 Gemini 的开源 AI 代理

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

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

分类: 开发工具第 147 / 438
Stars: ★ 107.4k 非常热门
运行环境: Node.js
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 10 天前

58FMRS · C

根据提供的 README，Gemini CLI 是 Apache-2.0 许可的开源终端 AI 代理，具备 MCP 客户端扩展能力；源材料未提供独立 MCP 服务器清单、传输方式或客户端兼容性证据。

最强项 · 维护活跃度 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

16/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 仅提供 README，未提供服务器 manifest、源码、MCP 初始化/工具列表握手证据或覆盖关键路径的测试；README 说明 Gemini CLI 支持 MCP，但该仓库根目录作为 MCP server 的实际启动方式和工具行为无法验证。因此只能认为基本路径可能可行，因缺少可复核的执行与错误处理证据而扣分。
安全与权限 8/20: README 提到文件操作、shell 命令、网页获取、Google Search 和 MCP 扩展，说明权限和外部数据边界可能较宽；虽列出沙箱、受信任文件夹、遥测和多种认证文档入口，但这些控制细节未在给定材料中展示。示例使用占位符而非真实凭据，因此无红线风险，但因最小权限、确认机制和数据流披露不足而扣分。
维护活跃度 16/20: 项目标明 Apache-2.0，提供稳定版、预览版和 nightly 发布渠道，链接 CI、路线图、贡献指南、问题跟踪及安全公告，并明确 Google 与开源社区维护背景。这显示出清晰的所有权、更新路径和安全响应入口；但仅有 README 和徽章，缺少实际提交、发布记录、依赖更新或问题响应证据，因此未给满分。
文档质量 14/20: README 覆盖安装、多个认证选项、基础命令、非交互模式、MCP 配置位置、功能范围、发布渠道、故障排查和安全相关文档入口，并提供若干示例。扣分原因是未提供 manifest、具体工具参数/协议细节、完整客户端配置、成本与限制的可复核内容，且部分细节仅通过外部链接引用。
安装易用性 12/20: 提供 npx、npm、Homebrew、MacPorts 和 Anaconda 安装路径，以及认证和基本 CLI 使用示例，主流开发环境的起步路径较清楚。扣分原因是没有实际 MCP server manifest、标准客户端连接配置、运行时版本要求或握手验证；给定材料也没有提交测试或 CI 中覆盖 server 关键路径的证据。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

习惯命令行工作的开发者
需要代码理解、生成和自动化能力的个人开发者与团队
希望接入自定义 MCP 工具的用户

不适合谁

寻找已有 MCP 工具清单的用户
需要独立部署并直接连接的 MCP 服务器的用户
不希望授予终端、文件或 Shell 操作能力的环境

所需权限

需要 Gemini 认证：Google 账号、Gemini API 密钥，或 Vertex AI 配置
文件操作和 Shell 命令能力取决于启用的内置工具及运行环境
使用 Google Search grounding 和网页获取时需要相应网络访问
企业 Code Assist 账号可能需要设置 GOOGLE_CLOUD_PROJECT

风险与副作用

文件操作和 Shell 命令可能影响当前项目或运行环境，应结合沙箱和可信文件夹设置使用
preview 和 nightly 发布渠道可能包含回归或未解决问题
API 密钥、Google 账号和云项目配置需要妥善保护

安装接入

准备工作

运行环境：Node.js

GEMINI_API_KEY 可选密钥 Gemini API 密钥，用于 API Key 认证方式，可从 https://aistudio.google.com/apikey 获取；也可改用 Google OAuth 登录。

GOOGLE_API_KEY 可选密钥 Vertex AI 方式使用的 Google Cloud API 密钥，需搭配 GOOGLE_GENAI_USE_VERTEXAI=true。

其他可选配置项（2 个）

GOOGLE_GENAI_USE_VERTEXAI 可选设为 true 时启用 Vertex AI 认证方式，适合企业生产环境。

GOOGLE_CLOUD_PROJECT 可选使用付费 Code Assist License 时需设置的 Google Cloud 项目 ID。

可使用 npx @google/gemini-cli 直接运行；也可运行 npm install -g @google/gemini-cli，或在 macOS/Linux 上使用 brew install gemini-cli。启动命令为 gemini。认证可选择 Google 账号、GEMINI_API_KEY，或 Vertex AI 相关环境变量。

验证是否装好

在终端运行 `npx @google/gemini-cli` 或 `gemini`，若成功启动交互式会话并可选择 Google 登录或输入 API Key，即说明安装成功。

常见排障

确认已完成 Google 账号登录，或正确设置 GEMINI_API_KEY、GOOGLE_API_KEY 和 GOOGLE_GENAI_USE_VERTEXAI
使用付费 Code Assist 许可时确认已设置 GOOGLE_CLOUD_PROJECT
检查所选发布渠道；需要稳定版本时使用 latest
MCP 服务器配置位置为 ~/.gemini/settings.json
遇到问题可查阅故障排除指南或使用 /bug 命令

试试这样问

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

总结一下昨天所有提交的变更内容
解释这个代码库的架构
根据我提供的 FAQ.md 写一个 Discord 问答机器人
运行测试并部署

使用场景

在终端分析和编辑大型代码库

使用自然语言调试问题和排查故障

通过脚本或 GitHub 工作流自动化任务

配置 MCP 服务器以扩展 Gemini CLI 的能力

详细介绍

Gemini CLI 是一个开源 AI 代理，将 Gemini 直接带入终端。它支持代码理解与生成、文件操作、Shell 命令、网页获取与 Google Search grounding，并可通过 MCP 扩展自定义集成。该仓库提供的是终端 AI 代理及 MCP 客户端能力，源材料未证明其本身提供可独立连接的 MCP 服务器或工具清单。