gemini-mcp-rs

中文文档

A high-performance Rust implementation of MCP (Model Context Protocol) server that wraps the Gemini CLI for AI-driven tasks.

Quick Start

The easiest way to use gemini-mcp-rs is via npx - no manual installation required:

npx @missdeer/gemini-mcp-rs

This command automatically installs the correct binary for your platform and runs it. To add it to Claude Code:

claude mcp add gemini-rs -s user --transport stdio -- npx @missdeer/gemini-mcp-rs

That's it! The MCP server is now available in Claude Code.

Features

• MCP Protocol Support: Implements the official Model Context Protocol using the Rust SDK
• Gemini Integration: Wraps the Gemini CLI to enable AI-driven tasks through MCP
• Session Management: Supports multi-turn conversations via session IDs
• Sandbox Safety: Configurable sandbox mode for isolated execution
• Async Runtime: Built on Tokio for efficient async I/O
• Cross-platform: Works on Windows, Linux, and macOS (x64 and arm64)

Prerequisites

• Rust 1.77.2+ (required for Windows batch file security fix, see CVE-2024-24576)
• Gemini CLI installed and configured
• Claude Code or another MCP client

Building

# Debug build
cargo build

# Release build
cargo build --release

Running

The server communicates via stdio transport:

cargo run

Or after building:

./target/release/gemini-mcp-rs

Command-Line Options

# Display help information
./target/release/gemini-mcp-rs --help

# Display version information
./target/release/gemini-mcp-rs --version

The --help flag provides comprehensive documentation including:

• Environment variables
• MCP client configuration examples
• All supported tool parameters
• GEMINI.md configuration file support
• Return structure format
• Best practices and security information

Installation

Option 1: NPX (Recommended)

Run directly using npx:

npx @missdeer/gemini-mcp-rs

npx handles everything automatically:

1. Installs the platform-specific binary package
2. Launches the MCP server on stdio transport

Or install globally:

npm install -g @missdeer/gemini-mcp-rs

Then add to your Claude MCP configuration:

claude mcp add gemini-rs -s user --transport stdio -- npx @missdeer/gemini-mcp-rs

Option 2: Quick Install (Linux/macOS)

Install the latest release with a single command:

curl -sSL https://raw.githubusercontent.com/missdeer/gemini-mcp-rs/master/scripts/install.sh | bash

Or install a specific version:

curl -sSL https://raw.githubusercontent.com/missdeer/gemini-mcp-rs/master/scripts/install.sh | bash -s v0.1.0

This script will:

• Detect your platform and architecture
• Download the appropriate binary from GitHub releases
• Install it to ~/.local/bin (or /usr/local/bin if needed)
• Automatically add it to your Claude MCP configuration

Option 3: Build from Source

git clone https://github.com/missdeer/gemini-mcp-rs.git
cd gemini-mcp-rs
cargo build --release
claude mcp add gemini-rs -s user --transport stdio -- $(pwd)/target/release/gemini-mcp-rs

Option 4: Install from Release

Download the appropriate binary for your platform from the releases page:

| Platform | Architecture | Asset | |----------|--------------|-------|

... View full README on GitHub