Gemini模型服务器

MCP Gemini是一个允许AI助手使用Google Gemini模型的服务,支持文本生成、图像分析、代码审查和多轮对话等功能。

  • by danjam
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 danjam/mcp-gemini

使用说明

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 电话:

  1. 第一条消息: { "prompt": "What is photosynthesis?", "conversationId": "chat-1" }
  2. 跟进: { "prompt": "Explain it to a 5-year-old", "conversationId": "chat-1" }

双子座在回答后续问题时会记住第一条信息。

对话在30分钟不活动后过期。


许可证

麻省理工学院