AI导哈

Gemini AI集成服务器

一个将Google的Gemini AI与Claude Desktop集成的模型上下文协议（MCP）服务器，允许用户直接从Claude向Gemini提问。

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

使用说明

Gemini MCP服务器

一个模型上下文协议（MCP）服务器，将谷歌的Gemini AI与Claude Desktop集成在一起，允许您直接从Claude那里向Gemini提问。

建筑

Claude Desktop → mcp-bridge.js → Java Spring Boot Server → Gemini API

该系统由以下部分组成：

  • Java Spring启动服务器：处理端口8811上的Gemini API调用
  • Node.js MCP桥：在MCP协议和HTTP调用之间进行转换
  • Claude桌面集成：提供 ask_gemini 工具

先决条件

  • Java 24+
  • Node.js 14+
  • Docker（可选）
  • 克劳德桌面
  • Google Gemini API密钥

设置

1.获取Gemini API密钥

  1. 访问 谷歌人工智能工作室
  2. 创建新的API密钥
  3. 将其导出为环境变量：
export GEMINI_API_KEY=your_api_key_here

2.构建和运行

选项A:Docker（推荐）

# Build the Docker image
./mvnw spring-boot:build-image 

# Run the container with default model (gemini-1.5-flash)
docker run -d --name gemini-mcp -p 8811:8811 -e GEMINI_API_KEY=$GEMINI_API_KEY gemini-mcp:0.0.1-SNAPSHOT

# Or specify a different Gemini model
docker run -d --name gemini-mcp -p 8811:8811 \
  -e GEMINI_API_KEY=$GEMINI_API_KEY \
  -e GEMINI_MODEL=gemini-1.5-pro \
  gemini-mcp:0.0.1-SNAPSHOT

方案B：地方发展

# Build with Maven
./mvnw clean package

# Run the JAR
java -jar target/gemini-mcp-0.0.1-SNAPSHOT.jar

3.配置克劳德桌面

  1. 找到您的Claude Desktop MCP配置文件：

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%/Claude/claude_desktop_config.json

  2. 添加以下配置：

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["mcp-bridge.js"],
      "cwd": "/path/to/your/gemini-mcp/project"
    }
  }
}

重要：替换 /path/to/your/gemini-mcp/project 带有此项目目录的实际路径。

  1. 重新启动克劳德桌面

4.验证安装

  1. 打开克劳德桌面
  2. 寻找🔧 界面中的工具图标
  3. 你应该看到一个 ask_gemini 工具可用
  4. 测试一下：“用ask_gemini给我讲个笑话”

用法

配置后，您可以使用 ask_gemini Claude Desktop中的工具：

Please use ask_gemini to explain quantum computing in simple terms

Can you ask_gemini what the weather is like today?

配置

可用型号

您可以通过设置来配置要使用的Gemini模型 GEMINI_MODEL 环境变量：

  • gemini-1.5-flash （默认）-快速响应，适用于大多数任务
  • gemini-1.5-pro -能力更强，更适合复杂的任务
  • gemini-1.0-pro -原始Gemini模型

环境变量

  • GEMINI_API_KEY （必需）：您的Google Gemini API密钥
  • GEMINI_MODEL （可选）：要使用的Gemini模型（默认为 gemini-1.5-flash)

配置文件

  • claude-desktop-mcp.json：MCP服务器配置示例
  • application.properties：默认型号的Spring Boot配置
  • mcp-bridge.js：Node.js MCP协议桥

故障排除

常见问题

工具未出现在Claude Desktop中：

  • 检查一下 cwd MCP配置中的路径正确
  • 确保 mcp-bridge.js 可执行
  • 配置更改后重新启动Claude Desktop

连接错误：

  • 验证Java服务器是否在端口8811上运行
  • 检查Docker容器日志： docker logs gemini-mcp
  • 确保Gemini API密钥有效并导出

API错误：

  • 验证Gemini API密钥是否正确
  • 在Google AI Studio中查看API配额和限制
  • 查看服务器日志以了解详细的错误消息

调试

查看容器日志：

docker logs -f gemini-mcp

直接测试HTTP端点：

curl -X POST http://localhost:8811/mcp \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello, Gemini!"}'

发展

项目结构：

├── src/main/java/com/baron/geminimcp/
│   ├── GeminiMcpApplication.java      # Spring Boot main class
│   ├── GeminiMcpController.java       # REST controller
│   └── GeminiResponse.java            # Response model
├── mcp-bridge.js                      # MCP protocol bridge
├── claude-desktop-mcp.json           # MCP configuration example
└── docker-compose.yml               # Docker Compose setup

许可证

MIT许可证

相关 MCP