@choplin/mcp-gemini-cli

中文文档
0.2.0发布于 2025/06/28MITTypeScriptES Module近 30 天下载 3728

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

中文使用文档
文档目录23 节
  1. 它会做什么
  2. 先决条件
  3. QQ 快速启动 Claude 代码
  4. 1. 添加 MCP 服务器
  5. 试试看
  6. QQ 安装选项
  7. 使用带有 -- allow-npx 旗的 npx
  8. 地方发展
  9. 可用的工具
  10. 1. 谷歌搜索
  11. 2. 子宫颈炎
  12. 示例提示
  13. 示例使用法
  14. 谷歌搜索
  15. 遗传
  16. 发展
  17. 在开发模式中运行
  18. 运行测试
  19. 生产建筑
  20. 显示格式( F)
  21. 捐款
  22. 许可证
  23. QQ 相关链接

MCP 双子座CLI

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

它会做什么

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

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

先决条件

  • 双子座CLI 安装和配置( 可选择使用 -- allow-npx 旗)

QQ 快速启动 Claude 代码

1. 添加 MCP 服务器

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

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

地方发展

  1. 克隆并安装 :
git clone https://github.com/choplin/mcp-gemini-cli
cd mcp-gemini-cli
bun install
  1. 添加到 Claude 桌面配置 :
{
  "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与承诺的区别"

示例使用法

谷歌搜索

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

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

遗传

// 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",
});

发展

说明发展需要 阿宝 运行时间.

在开发模式中运行

bun run dev

运行测试

bun test

生产建筑

# Development build
bun run build

# Production build (minified)
bun run build:prod

显示格式( F)

# Lint code
bun run lint

# Format code
bun run format

捐款

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

许可证

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

版本与发布记录

@choplin/mcp-gemini-cli 共发布 3 个版本,首次发布于 2025/06/26;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.2.0latest2025/06/281.4 年前
0.1.02025/06/261.4 年前
1.0.02025/06/261.4 年前

关于 @choplin/mcp-gemini-cli 的常见问题

@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 和提交记录判断。