AI导哈

Gemini MCP 服务器

Gemini MCP 服务器是一个本地运行的 Model Context Protocol (MCP) 服务器，提供对 Google 最新 Gemini Pro 模型的访问，支持 JSON-RPC 2.0 协议，适用于本地开发与 Claude Code 集成。

  • by mesolimbo
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 mesolimbo/gemini-mcp

使用说明

Gemini MCP服务器

一个模型上下文协议（MCP）服务器，提供对谷歌最新Gemini Pro模型的访问。此服务器通过npx在本地运行，与Claude Code无缝集成。

特性

  • 完全支持MCP协议：符合JSON-RPC 2.0的MCP服务器实现
  • Gemini Pro（最新）：使用 gemini-pro-latest 别名，始终跟踪谷歌最强大的Gemini模型
  • 本地执行：通过npx运行，便于本地开发
  • TypeScript实现：具有强大错误处理功能的全类型代码库
  • 可配置参数：控制温度和最大标记

设置

  1. 安装依赖项：
npm install
  1. 创建配置文件：
cp config.json.example config.json
  1. 编辑 config.json 使用Gemini API密钥：
{
  "geminiApiKey": "your-gemini-api-key-here"
}

从以下位置获取API密钥：https://aistudio.google.com/apikey

本地开发

在本地运行MCP服务器：

npm run dev

构建TypeScript代码：

npm run build

使用Claude代码

添加到您的 ~/.claude.json MCP服务器配置：

{
  "mcpServers": {
    "gemini": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "tsx",
        "C:/Users/mesol/workspace/gemini-mcp/src/index.ts"
      ],
      "env": {}
    }
  }
}

添加配置后，重新启动Claude Code以加载MCP服务器。

可用工具

query_gemini

查询谷歌最新的Gemini Pro型号：

参数：

  • prompt （必填）：发送给Gemini的提示
  • max_tokens （可选）：响应中的最大令牌数（默认值：8192）
  • temperature （可选）：响应生成温度，0.0至2.0（默认值：1.0）

示例用法：

{
  "name": "query_gemini",
  "arguments": {
    "prompt": "Explain quantum computing",
    "max_tokens": 4096,
    "temperature": 0.7
  }
}

建筑学

  • src/index.ts：带stdio传输的主MCP服务器入口点
  • src/config.ts：配置加载实用程序
  • config.json：API密钥配置（gitignored）
  • tsconfig.json：TypeScript配置

故障排除

连接问题

  1. API密钥错误：在中验证您的API密钥 config.json 正确
  2. 未找到配置：确保 config.json 存在（复制自 config.json.example)
  3. 节点版本：需要Node.js>=22.21.0

获取帮助

对于以下问题：

  • API双子星：访问https://ai.google.dev/gemini-api/docs
  • MCP协议：访问https://modelcontextprotocol.io
  • 此服务器：检查Claude Code中的错误日志

文件

  • config.json.example：配置模板
  • config.json：您的实际配置（根据示例创建，不在git中跟踪）
  • .gitignore：确保未提交config.json

许可证

麻省理工学院

相关 MCP