# @choplin/mcp-gemini-cli 中文文档

规范地址：https://npmcn.com/package/%40choplin/mcp-gemini-cli/

版本：0\.2\.0
npm 元数据更新时间：2025-06-28T07:53:43.986Z
中文译文更新时间：2026-11-09T14:36:25.782Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40choplin/mcp-gemini-cli
原文对照：https://npmcn.com/package/%40choplin/mcp-gemini-cli/?lang=original
项目主页：https://github.com/choplin/mcp-gemini-cli#readme
源码仓库：https://github.com/choplin/mcp-gemini-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：254 kB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：typescript ^5
- 首次发布：2025-06-26T11:17:18.224Z
- 最新版本发布：2025-06-28T07:53:43.803Z
- 近 30 天下载量：3728（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

谷歌双子座 CLI 的 MCP 服务器包

## 安装

```sh
npm install @choplin/mcp-gemini-cli
```

也可以使用：`pnpm add @choplin/mcp-gemini-cli`、`yarn add @choplin/mcp-gemini-cli`、`bun add @choplin/mcp-gemini-cli`

## README

# MCP 双子座CLI

为Google的双子座CLI提供简单的MCP服务器包装,使AI助手能够通过"模型背景协议"来使用双子座的能力.

## 它会做什么

这个服务器暴露出两个与双子座CLI相互作用的工具:

-   `googleSearch`: 要求双子座使用您的查询进行 Google 搜索
-   `geminiChat`: 直接向双子座发送提示进行一般性对话

## 先决条件

-   [双子座CLI](https://github.com/google-gemini/gemini-cli) 安装和配置( 可选择使用 -- allow-npx 旗)

## QQ 快速启动 Claude 代码

### 1\. 添加 MCP 服务器

```bash
claude mcp add -s project gemini-cli -- npx @choplin/mcp-gemini-cli --allow-npx
```

或者用下面安装选项部分显示的设置配置您的 MCP 客户端 .

### 试试看

示例提示:

-   **搜索**:"使用Google搜索最新类型脚本 5.0 特性"
-   **聊天**:"请双子座解释在JavaScript中Aync/await与承诺的区别"

## QQ 安装选项

### 使用带有 -- allow-npx 旗的 npx

```json
{
  "mcpServers": {
    "mcp-gemini-cli": {
      "command": "npx",
      "args": ["@choplin/mcp-gemini-cli", "--allow-npx"]
    }
  }
}
```

### 地方发展

1.  克隆并安装 :

```bash
git clone https://github.com/choplin/mcp-gemini-cli
cd mcp-gemini-cli
bun install
```

1.  添加到 Claude 桌面配置 :

```json
{
  "mcpServers": {
    "mcp-gemini-cli": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-gemini-cli/index.ts"]
    }
  }
}
```

## 可用的工具

### 1\. 谷歌搜索

使用双子座CLI进行谷歌搜索.

**参数:**

-   `query` (必须): 搜索查询
-   `limit` (可选):结果的最大数量
-   `sandbox` (可选):以沙盒模式运行
-   `yolo` (可选) : 跳过确认
-   `model` (可选):要使用的双子模型(默认:"gemini-2.5-pro")

### 2\. 子宫颈炎

和双子座谈谈.

**参数:**

-   `prompt` (必须): 对话提示
-   `sandbox` (可选):以沙盒模式运行
-   `yolo` (可选) : 跳过确认
-   `model` (可选):要使用的双子模型(默认:"gemini-2.5-pro")

## 示例提示

尝试这些提示可以看到 Mcp-gemini-cli 动作:

-   **搜索**:"使用Google搜索最新类型脚本 5.0 特性"
-   **聊天**:"请双子座解释在JavaScript中Aync/await与承诺的区别"

## 示例使用法

### 谷歌搜索

```typescript
// Simple search
googleSearch({ query: "latest AI news" });

// Search with limit
googleSearch({
  query: "TypeScript best practices",
  limit: 5,
});
```

### 遗传

```typescript
// Simple chat
geminiChat({ prompt: "Explain quantum computing in simple terms" });

// Using a different model
geminiChat({
  prompt: "Write a haiku about programming",
  model: "gemini-2.5-flash",
});
```

## 发展

> **说明**发展需要 [阿宝](https://bun.sh/) 运行时间.

### 在开发模式中运行

```bash
bun run dev
```

### 运行测试

```bash
bun test
```

### 生产建筑

```bash
# Development build
bun run build

# Production build (minified)
bun run build:prod
```

### 显示格式( F)

```bash
# Lint code
bun run lint

# Format code
bun run format
```

## 捐款

欢迎捐款! 请随意提交拉力请求.

## 许可证

这个项目根据麻省理工学院许可证获得许可----详情见LICENSE文件.

## QQ 相关链接

-   [示范背景协议(MCP)](https://modelcontextprotocol.io/)
-   [双子座CLI](https://github.com/google-gemini/gemini-cli)
-   [Bun 运行时间](https://bun.sh/)

## 常见问题

### @choplin/mcp-gemini-cli 是什么？

谷歌双子座 CLI 的 MCP 服务器包

### 如何安装 @choplin/mcp-gemini-cli？

在项目目录运行 npm install @choplin/mcp-gemini-cli，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 mcp-gemini-cli，可以用 npx mcp-gemini-cli 直接运行。

### @choplin/mcp-gemini-cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @choplin/mcp-gemini-cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @choplin/mcp-gemini-cli 可以商用吗？

@choplin/mcp-gemini-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @choplin/mcp-gemini-cli 的下载量有多少？

根据 npm 官方下载统计，@choplin/mcp-gemini-cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,728 次，日均约 124 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @choplin/mcp-gemini-cli 还在维护吗？

最新版本 0\.2\.0 发布于 2025/06/28（1\.4 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/06/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。