使用说明
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许可证-请参阅 许可证 文件以获取详细信息。
