使用说明
MCP Gemini
一 主控程序 让AI助手使用谷歌的服务器 双子座 模型。生成文本、分析图像、查看代码等,支持多回合对话和基于网络的答案。
适用于Claude Desktop、Claude Code或任何兼容MCP的客户端。
用例
- 获取关于代码审查的第二意见
- 分析屏幕截图或图表
- 总结或翻译长篇文档
- 与双子座进行多轮对话,进行头脑风暴
- 通过谷歌搜索获得最新答案
- 生成结构化JSON以供其他工具使用
设置
需要 Node.js 18+.
1.获取Gemini API密钥
首选 谷歌AI工作室 并创建API密钥。
2.配置您的MCP客户端
将服务器添加到MCP客户端的配置中。有两种方法可以做到这一点:
选项A:直接从GitHub运行(无需安装)
{
"mcpServers": {
"gemini": {
"command": "npx",
"args": ["-y", "github:danjam/mcp-gemini"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}
选项B:克隆并在本地运行
git clone https://github.com/danjam/mcp-gemini.git
cd mcp-gemini
npm install
然后将MCP客户端指向本地版本:
{
"mcpServers": {
"gemini": {
"command": "node",
"args": ["/path/to/mcp-gemini/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}
替换 /path/to/mcp-gemini 使用克隆项目的实际路径。
更改默认模型
默认情况下,服务器使用 gemini-flash-latest。要更改此设置,请添加 GEMINI_DEFAULT_MODEL 您的环境:
"env": {
"GEMINI_API_KEY": "your-api-key-here",
"GEMINI_DEFAULT_MODEL": "gemini-pro-latest"
}
你能做什么
生成文本
让双子座写、回答问题、总结、翻译或其他任何基于文本的东西。
工具: generate_text
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt |
string | 是的 | 你想让双子座做什么 |
model |
string | 否 | 使用哪个模型 |
systemInstruction |
string | 否 | 设定基调或角色(例如“你是一位乐于助人的导师”) |
temperature |
number | 否 | 反应有多有创意(0=专注,2=有创意)。默认值:0.7 |
maxTokens |
number | 否 | 限制响应长度。默认值:2048 |
grounding |
boolean | 否 | 让Gemini在网上搜索最新答案 |
conversationId |
string | 否 | 继续多回合对话(见下文) |
jsonMode |
boolean | 否 | 获取结构化JSON格式的响应 |
jsonSchema |
object | 否 | 定义JSON响应的确切形状 |
safetySettings |
array | 否 | 调整内容筛选阈值 |
分析图像
发送一张图片并询问相关问题——描述照片中的内容,阅读屏幕截图中的文本,识别对象等等。提供其中之一 imageUrl 或 imageBase64.
工具: analyze_image
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt |
string | 是 | 您对图像的问题 |
imageUrl |
string | 否 | 要分析的图像的URL |
imageBase64 |
string | 否 | Base64编码图像(有或没有数据URI前缀) |
model |
string | 否 | 使用哪个模型 |
列出型号
查看所有可用的Gemini型号。不需要参数。
工具: list_models
代码审查
检查代码差异,查看是否存在错误、样式问题、安全问题和改进。使用低温(0.3)进行集中、一致的反馈。
工具: code_review
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
diff |
string | 是 | 要查看的代码差异或代码 |
context |
string | 否 | 关注领域或其他上下文(例如“关注安全”) |
model |
string | 否 | 使用哪个模型 |
maxTokens |
number | 否 | 限制响应长度。默认值:4096 |
注: 使用 list_models 查看可用模型或直接传递任何模型名称。Pro型号在免费版上不可用——如果你看到配额错误,请切换到Flash型号或升级你的计划。
对话
你可以进行多轮对话,让双子座记住之前说过的话。通过相同 conversationId 跨多个 generate_text 电话:
- 第一条消息:
{ "prompt": "What is photosynthesis?", "conversationId": "chat-1" } - 跟进:
{ "prompt": "Explain it to a 5-year-old", "conversationId": "chat-1" }
双子座在回答后续问题时会记住第一条信息。
对话在30分钟不活动后过期。