AI导哈

Gemini MCP 服务器

一个模型上下文协议（MCP）服务器，提供与Google的Gemini CLI的桥梁，允许MCP兼容的客户端（如Claude Desktop）直接与Gemini CLI交互以启动新的聊天会话或继续现有会话。

  • by 2lab-ai
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 2lab-ai/gemini-mcp-server

使用说明

Gemini MCP服务器

一个模型上下文协议（MCP）服务器，为谷歌的Gemini CLI提供桥梁。这允许符合MCP的客户端（如Claude Desktop）与Gemini CLI交互，以直接从客户端界面启动新的聊天会话或继续现有的会话。

特性

  • 开始新会话：与特定的双子座模特展开新的对话。
  • 继续会话：使用会话ID回复现有会话。
  • 会话管理：如果没有为答复提供最新会话ID，则自动检测。
  • 模型选择：支持指定不同的Gemini模型（例如。， gemini-3-pro).

先决条件

在使用此服务器之前，请确保已安装以下内容：

  1. Node.js：v18或更高版本。
  2. 双子座命令行界面：你一定有 gemini 在您的系统上安装并配置了CLI工具。
    • 确保 gemini 在系统的PATH中。
    • 请确保您已通过身份验证或为 gemini CLI工作。

安装

您可以直接使用以下命令运行此服务器 npx 或者在当地建造。

本地设置

  1. 克隆存储库：

    git clone <repository-url>
cd gemini-mcp-server

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

配置

要将此功能用于MCP客户端（例如Claude Desktop），请将服务器配置添加到客户端的设置文件中。

Claude桌面配置

将以下内容添加到您的 claude_desktop_config.json （通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

使用源代码（用于开发）： MCP（模型上下文协议）服务器，用于与谷歌的Gemini CLI交互。

该服务器允许像克劳德这样的人工智能助手通过MCP协议使用谷歌的Gemini。

先决条件

# Install Gemini CLI
npm install -g @anthropic-ai/gemini-cli
# or
brew install gemini-cli

# Authenticate
gemini auth

安装

全球安装

npm install -g @2lab.ai/gemini-mcp-server

直接使用npx运行

npx @2lab.ai/gemini-mcp-server

用法

运行服务器

全局安装后：

gemini-mcp-server

或者使用npx：

npx @2lab.ai/gemini-mcp-server

MCP检验员测试

您可以使用MCP检查器测试和调试服务器：

npx @modelcontextprotocol/inspector npx @2lab.ai/gemini-mcp-server

或者，如果全局安装：

npx @modelcontextprotocol/inspector gemini-mcp-server

Claude桌面配置

将以下内容添加到您的Claude Desktop配置文件中：

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

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@2lab.ai/gemini-mcp-server"]
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "gemini": {
      "command": "gemini-mcp-server"
    }
  }
}

Claude代码配置

添加到您的克劳德代码设置中：

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@2lab.ai/gemini-mcp-server"]
    }
  }
}

可用工具

gemini

以提示开始新的Gemini会话。

参数：

  • prompt （必填）：开始会话的提示
  • model 可选：要使用的模型（例如，“gemini-3-pro”、“gemini3-flash”）。

退货： 响应文本和新会话ID

gemini-reply

继续现有的Gemini会话。

参数：

  • prompt （必填）：继续对话的提示
  • sessionId （可选）：要继续的会话ID。如果未提供，则使用最新会话
  • model （可选）：此回合使用的模型

退货： 响应文本

发展

# Clone the repository
git clone https://github.com/2lab-ai/gemini-mcp-server.git
cd gemini-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

CI/CD

此项目使用GitHub Actions在将更改推送到npm时自动发布到npm main 支。

要启用自动发布，请执行以下操作：

  1. 从以下位置生成npm访问令牌 npmjs.com
  2. 将令牌添加为名为的秘密 NPM_TOKEN 在GitHub存储库设置中
  3. 将版本插入 package.json 在触发发布之前

许可证

国际学生委员会

相关 MCP