内容
# Gemini CLI MCP 服务器
**Gemini CLI 的快速 MCP 服务器** — 从任何 MCP 客户端使用 Gemini 模型。
- **PyPI:** `pip install gemini-cli-mcp-fast`
- **许可证:** MIT
- **要求:** Python ≥3.11, Node.js, Gemini CLI
## 前置条件
```bash
npm install -g @google/gemini-cli
gemini --version # 验证安装
gemini # 运行一次以完成 OAuth 登录
```
## 安装
```bash
pip install gemini-cli-mcp-fast
```
作为模块运行：
```bash
python -m gemini_mcp_server
```
## 配置 — Hermes Agent
添加到 `~/.hermes/config.yaml`:
```yaml
mcp_servers:
gemini-cli:
command: "python3"
args: ["-m", "gemini_mcp_server"]
timeout: 240
```
工具以 `mcp_gemini_cli_*` 形式可用。
## 配置 — Claude Desktop
```json
{
"mcpServers": {
"gemini-cli": {
"command": "python3",
"args": ["-m", "gemini_mcp_server"]
}
}
}
```
## 工具
### `gemini_prompt`
向 Gemini CLI 发送任意提示，非交互式。默认安全 — 使用 `--approval-mode auto-edit`。传递 `dangerous=true` 以启用完全 yolo 模式。
**参数：**
| 参数 | 类型 | 必需 | 默认值 | 描述 |
|-----------|------|----------|---------|-------------|
| `prompt` | 字符串 | ✅ | — | 最大约 100K 字符 |
| `model` | 字符串 | ❌ | CLI 默认值 | 例如 `gemini-2.5-flash` |
| `output_format` | 字符串 | ❌ | `text` | `text`、`json` 或 `stream-json` |
| `dangerous` | 布尔值 | ❌ | `false` | 使用 `--approval-mode yolo` |
### `gemini_plan`
只读审计和审查模式。使用 `--approval-mode plan` — 保证不会发生文件突变或 shell 执行。
**参数：**
| 参数 | 类型 | 必需 | 默认值 | 描述 |
|-----------|------|----------|---------|-------------|
| `prompt` | 字符串 | ✅ | — | 分析/审查请求 |
| `model` | 字符串 | ❌ | CLI 默认值 | Gemini 模型 |
| `include_directories` | 字符串 | ❌ | — | 以逗号分隔的附加目录 |
### `gemini_version`
返回已安装的 Gemini CLI 版本。
## 验证
```bash
python -c "
import gemini_mcp_server as s
print('版本：', s.gemini_version())
print('提示：', s.gemini_prompt('用一个词说 hello'))
print('计划：', s.gemini_plan('这个服务器有哪些工具？'))
"
```
## 许可证
MIT
