Skip to main content
Glama
enesjakozh

Gemini MCP Server for Claude Desktop

by Garblesnarff
npmGitHub
JavaScript
MIT License
14
14
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

适用于 Claude 桌面的 Gemini MCP 服务器

模型上下文协议 (MCP) 服务器使 Claude Desktop 能够使用 Google 的 Gemini AI 模型生成图像。

🌟 功能

  • 使用 Google 的 Gemini 模型直接从 Claude Desktop 生成图像

  • 简易的设置向导，方便配置

  • 可定制的图像生成参数

  • 与 Claude Desktop 的 MCP 服务器系统集成

  • 详细的日志记录和调试功能

  • Docker 支持，轻松部署和共享

📋 要求

  • Node.js 16.x 或更高版本

  • Claude桌面应用程序

  • Google Gemini API 密钥（在此获取）

  • Docker（可选，用于容器化部署）

🚀 安装

全局安装（推荐）

npm install -g gemini-mcp-server # Run the setup wizard npx gemini-mcp-setup

本地安装

# Create a directory for the server mkdir gemini-mcp-server cd gemini-mcp-server # Install locally npm install gemini-mcp-server # Run the setup wizard npx gemini-mcp-setup

Docker 安装

您还可以使用 Docker 运行 Gemini MCP 服务器：

# Build the Docker image docker build -t gemini-mcp-server . # Run the Docker container docker run -e GEMINI_API_KEY="your-api-key" -e OUTPUT_DIR="/app/output" -v /path/on/host:/app/output gemini-mcp-server

⚙️ 设置

安装向导将指导您完成配置过程：

  1. 输入您的 Google Gemini API 密钥

  2. 指定生成图像的保存目录

  3. 配置日志记录和模型设置

  4. 自动为 Claude Desktop 创建包装脚本

  5. 更新您的 Claude Desktop 配置

如果您更喜欢手动设置，请参阅下面的手动配置部分。

🎨 使用 Gemini MCP 服务器

安装并配置完成后，重新启动 Claude Desktop 以启用 Gemini MCP 服务器。然后：

  1. 与 Claude 开始对话

  2. 让 Claude 为你生成一张图片，例如：

    • “生成日落时分的山景图像”

    • “描绘一个有飞行汽车的未来城市”

    • “制作一幅猫弹钢琴的插图”

Claude 将调用 Gemini API 来生成图像并为您提供保存的图像文件的路径。

高级选项

您可以使用附加参数自定义图像生成：

  • 风格：指定“现实主义”、“艺术主义”、“简约主义”等风格。

  • 温度：控制生成的创造力/随机性（0.0-1.0）

例如：“生成一幅赛博朋克城市图像，其霓虹灯风格逼真，温度为 0.7”

🔧 手动配置

如果您不想使用安装向导，请按照以下步骤操作：

1.创建配置文件

使用您的设置创建一个 JSON 配置文件：

{ "apiKey": "YOUR_GEMINI_API_KEY_HERE", "outputDir": "/path/to/your/output/directory", "debug": true, "modelOptions": { "model": "gemini-2.0-flash-exp", "temperature": 0.4 } }

2. 创建包装脚本

创建一个 bash 脚本来运行服务器：

#!/bin/bash # Set environment variables export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE" export OUTPUT_DIR="/path/to/your/output/directory" export DEBUG="true" # Execute the server exec "$(which node)" "$(npm root -g)/gemini-mcp-server/bin/gemini-mcp-server.js"

使脚本可执行：

chmod +x gemini-mcp-wrapper.sh

3.更新Claude桌面配置

编辑~/.config/claude/claude_desktop_config.json文件以添加 Gemini MCP 服务器：

{ "mcpServers": { "gemini-image": { "command": "/bin/bash", "args": [ "-c", "/path/to/your/gemini-mcp-wrapper.sh" ], "env": { "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE", "DEBUG": "true" } } } }

🐳 Docker 部署

此 MCP 服务器包含一个 Dockerfile，方便部署和共享。Docker 镜像配置如下：

  • 使用 Node.js 16 Alpine 作为轻量级基础

  • 安装所有必要的依赖项

  • 在/app/output设置默认输出目录

  • 允许通过环境变量进行配置

构建 Docker 镜像

docker build -t gemini-mcp-server .

使用 Docker 运行

docker run \ -e GEMINI_API_KEY="your-api-key" \ -e OUTPUT_DIR="/app/output" \ -e DEBUG="false" \ -v /path/on/host:/app/output \ gemini-mcp-server

Docker 的环境变量

运行 Docker 容器时，您可以使用以下环境变量配置服务器：

  • GEMINI_API_KEY ：您的 Google Gemini API 密钥（必需）

  • OUTPUT_DIR ：保存生成的图像的目录（默认值： /app/output ）

  • DEBUG ：启用调试日志记录（默认值： false ）

与 Claude Desktop 一起使用

当使用带有 Claude Desktop 的 Docker 容器时，您需要：

  1. 确保容器正在运行

  2. 配置 Claude Desktop 连接到容器化服务器

  3. 将输出目录映射到 Claude 可访问的位置

📚 API 文档

命令行界面

gemini-mcp-server [options]

选项：

  • -k, --api-key <key> ：Google Gemini API 密钥

  • -o, --output-dir <dir> ：保存生成的图像的目录

  • -d, --debug ：启用调试日志记录

  • -c, --config <path> ：自定义配置文件的路径

  • -r, --reset-config ：将配置重置为默认值

  • -v, --version ：显示版本信息

环境变量

  • GEMINI_API_KEY ：您的 Google Gemini API 密钥

  • OUTPUT_DIR ：保存生成的图像的目录

  • DEBUG ：启用调试日志记录（ true或false ）

  • LOG_LEVEL ：设置日志级别（ ERROR 、 WARN 、 INFO或DEBUG ）

  • GEMINI_LOG_FILE ：自定义日志文件路径

配置选项

选项

描述

默认

apiKey

Google Gemini API 密钥

（必需的）

outputDir

保存生成的图像的目录

~/Claude/gemini-images

debug

启用调试日志记录

false

modelOptions.model

使用 Gemini 模型

gemini-2.0-flash-exp

modelOptions.temperature

控制创造力/随机性

0.4

modelOptions.topK

Top-k采样参数

32

modelOptions.topP

Top-p 抽样参数

1

modelOptions.maxOutputTokens

最大输出令牌

8192

🔍 故障排除

常见问题

服务器未启动或 Claude 无法连接

  1. 检查日志文件~/Claude/logs/gemini-image-mcp.log

  2. 验证您的 API 密钥是否正确

  3. 确保所有目录都存在并且具有适当的权限

  4. 重启Claude桌面

未生成图像

  1. 验证您的 Google Gemini API 密钥是否具有正确的权限

  2. 检查输出目录是否存在且可写

  3. 检查日志中的具体错误消息

  4. 尝试不同的提示或模型

错误：“未找到方法”

这通常意味着 Claude 正在尝试调用 MCP 服务器不支持的方法。请检查日志以查看请求的方法。

Docker 特定问题

  1. 确保容器具有正确的网络连接

  2. 检查卷挂载是否配置正确

  3. 验证环境变量是否正确设置

  4. 使用docker logs [container-id]查看容器日志

调试模式

启用调试模式以获取更详细的日志：

npx gemini-mcp-server --debug

或者设置环境变量：

export DEBUG=true npx gemini-mcp-server

📝 许可证

麻省理工学院

🙏 致谢

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

一个服务器，使 Claude Desktop 能够通过模型上下文协议 (MCP) 使用 Google 的 Gemini AI 模型生成图像。

  1. 🌟 功能
    1. 📋 要求
      1. 🚀 安装
        1. 全局安装（推荐）
        2. 本地安装
        3. Docker 安装
      2. ⚙️ 设置
        1. 🎨 使用 Gemini MCP 服务器
          1. 高级选项
        2. 🔧 手动配置
          1. 1.创建配置文件
          2. 2. 创建包装脚本
          3. 3.更新Claude桌面配置
        3. 🐳 Docker 部署
          1. 构建 Docker 镜像
          2. 使用 Docker 运行
          3. Docker 的环境变量
          4. 与 Claude Desktop 一起使用
        4. 📚 API 文档
          1. 命令行界面
          2. 环境变量
          3. 配置选项
        5. 🔍 故障排除
          1. 常见问题
          2. 调试模式
        6. 📝 许可证
          1. 🙏 致谢

            Related MCP Servers

            • Gemini MCP Server

              aliargun
              -
              security
              -
              license
              -
              quality
              Model Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.
              Last updated -
              226
              MIT License
              • Apple
              • Linux

            • Gemini MCP Server

              palolxx
              -
              security
              -
              license
              -
              quality
              An MCP server implementation that allows using Google's Gemini AI models (specifically Gemini 1.5 Pro) through Claude or other MCP clients via the Model Context Protocol.
              Last updated -
              1

            • Gemini MCP Server

              dakrin
              -
              security
              -
              license
              -
              quality
              A Model Context Protocol server that enables Claude Desktop to interact with Google's Gemini 2.5 Pro Experimental AI model, with features like Google Search integration and token usage reporting.
              Last updated -
              3

            • MCP Gemini Server

              -
              security
              -
              license
              -
              quality
              An MCP server that enables other AI models (like Claude) to use Google's Gemini models as tools for specific tasks through a standardized interface.

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Garblesnarff/gemini-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server