Gemini CLI MCP 服务

Gemini CLI MCP 服务是一个简单的 MCP 服务器包装器,使 AI 助手能够通过模型上下文协议使用 Gemini 的功能。

  • by Cinnamobot
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Cinnamobot/gemini-cli-mcp-server

使用说明

Gemini CLI MCP服务器

🇯🇵 日本语

谷歌的一个简单的MCP服务器包装器 Gemini CLI 这使得AI助手能够通过模型上下文协议使用Gemini的功能。

✨ 特性

  • 4工具: googleSearch, chat, listSessions, analyzeFile
  • 会话保持:使用会话ID恢复以前的对话(支持自定义ID)
  • 国际化:英语和日语支持
  • 交叉平台的:兼容Windows、macOS和Linux

🚀 快速设置

使用克劳德代码

claude mcp add -s project gemini-cli -- npx gemini-cli-mcp-server --allow-npx

手动配置

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

🛠️ 可用工具

谷歌搜索

使用Gemini CLI执行谷歌搜索。

参数 必填 说明
query ✅ 搜索查询
limit 最大结果数
raw 返回带URL的结构化结果
model Gemini模型(默认值: gemini-2.5-pro)

聊天

和双子座谈谈。

参数 必填 说明
prompt ✅ 对话提示
sessionId 恢复上一个会话(支持自定义ID,如“我的任务”)
model Gemini模型(默认值: gemini-2.5-pro)

listSessions

列出可用的Gemini CLI会话。返回可用于聊天的会话ID sessionId 参数。

analyze文件

使用Gemini的多模式功能分析文件。

参数 必填 说明
filePath ✅ 文件的绝对路径
prompt 附加分析说明
sessionId 恢复上一个会话(保持上下文)
model Gemini模型(默认值: gemini-2.5-pro)

支持的文件类型:

  • 图像:PNG、JPG、JPEG、GIF、WEBP、SVG、BMP
  • 文本:TXT,MD
  • 文件:PDF

💾 会话管理

您可以使用 自定义会话ID (客户端ID)来管理对话。服务器会自动将这些映射到Gemini CLI的内部会话ID。

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "chat",
    "arguments": {
      "prompt": "Hello!",
      "sessionId": "my-task-1"
    }
  },
  "id": 1
}
  • 持久性:映射存储在 记忆。如果MCP服务器重新启动,它们将被重置(Gemini的内部历史记录仍然存在,但与您的自定义ID的链接丢失)。
  • 挂牌:使用 listSessions 查看活动映射。

🌐 语言设置

工具说明和错误消息支持多种语言:

# Japanese
MCP_LANGUAGE=ja npx gemini-cli-mcp-server --allow-npx

# English (default)
MCP_LANGUAGE=en npx gemini-cli-mcp-server --allow-npx

系统区域设置(例如。, LANG=ja_JP.UTF-8)也会自动检测。

📝 发展

# Clone and install
git clone https://github.com/Cinnamobot/gemini-cli-mcp-server
cd gemini-cli-mcp-server
bun install

# Run tests
bun test

# Build
bun run build

🙏 学分

该项目基于 choplin/mcp-gemini cli.

叉子添加

  • listSessions工具:列出可用的Gemini CLI会话
  • 会话持续:恢复对话 sessionId 参数
  • 国际化:日语/英语支持
  • Windows兼容性:自定义 findExecutable 功能(否 which/where 依赖性)
  • CI/CD:GitHub自动化测试和构建操作

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🔗 相关链接