Skip to main content
Glama
Gemini Daily MCP Server (Compressed)

Gemini Daily MCP Server (Compressed)

by kdoooh000h

Gemini Daily MCP Server (Compressed) ⚑

npm version license

Token-optimized MCP server for Google Gemini CLI with 43.8% token savings through Progressive Disclosure strategy.

🎯 Why Compressed Version?

This is an experimental token-optimized variant of gemini-daily-mcp that reduces tool schema overhead by 43.8% while maintaining full functionality.

Token Savings Comparison

Version

Schema Size

Tokens

Savings

Original

1,227 bytes

306 tokens

-

Compressed ⚑

691 bytes

172 tokens

43.8%

Impact:

  • Per conversation: Save 134 tokens

  • 3,000 conversations/month: Save ~$1.61/month

  • Scale to 50 tools: Save ~$66/month (61%)

Related MCP server: Gemini Bridge

πŸ’‘ How It Works: Progressive Disclosure

Traditional Approach (Verbose Schema)

{
  "name": "gemini",
  "description": "Execute Gemini CLI in non-interactive mode for AI assistance with high Token efficiency",
  "inputSchema": {
    "properties": {
      "prompt": {
        "type": "string",
        "description": "The coding task, question, or analysis request"
      },
      "sessionId": {
        "type": "string",
        "description": "Optional session ID for conversational context (saves up to 74% tokens in multi-turn conversations)"
      }
    }
  }
}

Size: 731 bytes β‰ˆ 182 tokens

Progressive Disclosure (Compressed Schema)

{
  "name": "gemini",
  "description": "Execute Gemini CLI. Use help for details",
  "inputSchema": {
    "properties": {
      "prompt": {"type": "string"},
      "sessionId": {"type": "string"}
    }
  }
}

Size: 281 bytes β‰ˆ 70 tokens (61.6% savings)

Where Did the Details Go?

They're in the enhanced help tool! When Claude needs details:

# Claude calls: mcp__gemini-daily-compressed__help
# Returns comprehensive documentation:

# Gemini Daily MCP - Detailed Documentation

## gemini Tool

Execute Gemini CLI in non-interactive mode for AI assistance.

**Parameters:**
- prompt (required, string): The coding task, question, or analysis request
- sessionId (optional, string): Session ID for conversational context
  - Saves up to 74% tokens in multi-turn conversations
  - Obtained from previous gemini call's _meta.sessionId
- resetSession (optional, boolean): Reset session history before processing
- model (optional, string): Specify which Gemini model to use
  - Default: gemini-2.5-flash
  - Options: gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.5-pro, gemini-3-pro-preview

**Example:**
{
  "prompt": "Write a Python function to calculate fibonacci",
  "sessionId": "session-abc123",
  "model": "gemini-2.5-flash"
}
...

Result:

  • βœ… 90% of conversations: Don't need details β†’ Save tokens

  • βœ… 10% of conversations: Call help once β†’ Get full docs

  • βœ… Overall: 43.8% token savings

πŸš€ Features

Same Functionality as Original

  • βœ… Full Gemini CLI integration

  • βœ… Session management (saves up to 74% tokens in multi-turn conversations)

  • βœ… Gemini 3 support (gemini-3-pro-preview with fallback)

  • βœ… Multi-model selection (Flash, Flash-Lite, Pro, Gemini 3)

  • βœ… Comprehensive error handling

Token Optimization

  • ⚑ 43.8% smaller tool schemas

  • ⚑ Progressive Disclosure via enhanced help tool

  • ⚑ Preserves all type information

  • ⚑ Maintains parameter validation

πŸ“¦ Installation

Prerequisites

  • Google Gemini CLI must be pre-installed and configured

    • Install: Follow Google's official Gemini CLI installation guide

    • Setup: Run gemini auth login with your Google account

    • API Key: Set GOOGLE_API_KEY environment variable or configure via gemini config

  • Claude Code or Claude Desktop installed

Claude Code

# Clone this repository
git clone https://github.com/kdoooh000h/gemini-daily-mcp-compressed.git
cd gemini-daily-mcp-compressed

# Install dependencies
npm install

# Build
npm run build

# Add to Claude Code
# Edit your .mcp.json:
{
  "mcpServers": {
    "gemini-daily-compressed": {
      "command": "node",
      "args": ["/path/to/gemini-daily-mcp-compressed/dist/index.js"],
      "env": {
        "GEMINI_ENABLED": "true",
        "SESSION_TTL_HOURS": "24",
        "MAX_SESSIONS": "100",
        "GEMINI_CLI_COMMAND": "gemini",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gemini-daily-compressed": {
      "command": "node",
      "args": ["/path/to/gemini-daily-mcp-compressed/dist/index.js"],
      "env": {
        "GEMINI_ENABLED": "true",
        "SESSION_TTL_HOURS": "24",
        "GEMINI_CLI_COMMAND": "gemini"
      }
    }
  }
}

πŸ”§ Tools

gemini - AI Coding Assistant

Execute Gemini CLI with optional session support.

Basic Usage:

Use gemini to explain this Python function

Advanced Usage:

# With session for multi-turn conversation
Use gemini with sessionId "my-session" to analyze this code

# Continue conversation
Use gemini with sessionId "my-session" to implement the improvements

# Specify model
Use gemini with model "gemini-3-pro-preview" for complex analysis

# Reset session
Use gemini with sessionId "my-session" and resetSession true to start fresh

listSessions - Session Management

List all active conversation sessions.

ping - Connection Test

Test if the MCP server is working properly.

help - Enhanced Documentation

Get detailed documentation for all tools (this is where the detailed info lives in the compressed version).

πŸ“Š Compression Details

Strategy

  1. Remove verbose descriptions from tool schemas

  2. Preserve all functionality:

    • Parameter names

    • Type information

    • Required fields

    • Enum values

  3. Enhance help tool to provide complete documentation

Token Breakdown

Tool

Original

Compressed

Savings

gemini

182 tokens

70 tokens

61.6%

ping

49 tokens

37 tokens

24.5%

help

33 tokens

32 tokens

3.0%

listSessions

40 tokens

33 tokens

17.5%

Total

306 tokens

172 tokens

43.8%

Trade-offs

Pros βœ…:

  • Significant token savings (43.8%)

  • Lower costs ($66/month for 3K conversations with 50 tools)

  • Full functionality preserved

  • Claude understands compressed schemas

Cons ⚠️:

  • ~10% of conversations may need an extra help call

  • Schema less readable for developers

  • Need to maintain documentation in two places (schema + help tool)

πŸ“ˆ When to Use Compressed Version?

  • High-frequency usage (>100 conversations/day)

  • Many tools (>20 tools in your MCP setup)

  • Cost-sensitive projects

  • Complex tool schemas with verbose descriptions

Use Original Version Instead

  • Low-frequency usage (<100 conversations/day)

  • Few tools (<10 tools)

  • Need maximum schema readability

  • Occasional use

πŸ§ͺ Experimental Status

This is an experimental project to validate the Progressive Disclosure approach for MCP tool schemas.

Testing Results (from lab-02-testbed):

  • βœ… All tools function normally

  • βœ… help tool provides complete documentation

  • βœ… Claude understands compressed schemas

  • βœ… 43.8% token savings confirmed

  • ⚠️ ~10% scenarios require help call (adds 1 tool invocation)

Feedback Welcome: Please open issues if you encounter any problems or have suggestions.

πŸ“š Documentation

  • MODELS.md: Gemini model compatibility and selection guide

  • CODEX-TO-GEMINI-ADAPTATION.md: How this was adapted from codex-mcp-server

  • API Reference: Use the help tool within Claude for detailed documentation

πŸ› οΈ Development

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Test
npm test

# Lint
npm run lint

πŸ“ Version Compatibility

This MCP server is compatible with:

  • Gemini CLI: v0.17.0+ (with Gemini 3 support)

  • Claude Code: Latest version

  • Claude Desktop: Latest version

  • MCP SDK: @modelcontextprotocol/sdk ^1.17.3

🀝 Contributing

This is an experimental project. Contributions, issues, and feature requests are welcome!

πŸ“„ License

ISC

πŸ’¬ Questions?

  • Use the help tool: mcp__gemini-daily-compressed__help

  • Open an issue: GitHub Issues

  • Original project: gemini-daily-mcp


⚑ Compressed. Efficient. Same Power.

Available Tools

4 tools
geminiD

Execute Gemini CLI. Use help for details

Inputs: prompt (required), sessionId, resetSession, model.

helpC

Get detailed documentation

Inputs: no named parameters.

listSessionsB

List active sessions

Inputs: no named parameters.

pingC

Test connection

Inputs: message.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: gemini executes CLI commands, help provides documentation, listSessions shows active sessions, and ping tests connectivity. There is no overlap or ambiguity between these functions.

    Naming Consistency2/5

    Naming is inconsistent: gemini and ping use lowercase, help is lowercase but a generic verb, and listSessions uses camelCase. There is no uniform verb_noun pattern or consistent casing style across the set.

    Tool Count5/5

    With 4 tools, this is well-scoped for a server focused on Gemini CLI interaction and session management. Each tool serves a clear, necessary function without bloat or redundancy.

    Completeness3/5

    For a Gemini CLI server, core operations like execution, help, and session listing are covered, but there are notable gaps such as creating or managing sessions, handling specific Gemini commands directly, or error handling tools. The surface is functional but limited.

    Related MCP Connectors

    Related MCP Servers