AI CLI MCP Server

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   Model Context Protocol server for Gemini CLI + Codex CLI      │
│                                                                 │
│   Claude ──────────── Gemini / Codex                            │
│                                                                 │
│   Leverage Gemini's massive token window or Codex's             │
│   advanced reasoning for large file and codebase analysis       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Version 3.0.0 License MIT

Prerequisites

Node.js ≥ 16.0.0
Google Gemini CLI (configured)

Installation

Recommended

claude mcp add ai-cli -- npx -y @maxanatsko/ai-cli-mcp-server

Local Development

git clone https://github.com/maxanatsko/ai-cli-mcp-server.git
cd ai-cli-mcp-server

npm install
npm run build
npm link

claude mcp add ai-cli -- ai-cli-mcp

Verify

/mcp

Configuration

Claude Desktop

{
  "mcpServers": {
    "ai-cli": {
      "command": "npx",
      "args": ["-y", "@maxanatsko/ai-cli-mcp-server"]
    }
  }
}

Config Locations

macOS     ~/Library/Application Support/Claude/claude_desktop_config.json
Windows   %APPDATA%\Claude\claude_desktop_config.json
Linux     ~/.config/claude/claude_desktop_config.json

Usage

File Analysis

ask gemini to analyze @src/main.js
use gemini to summarize @.
analyze @package.json dependencies

General Questions

ask gemini about React best practices
use gemini to explain div centering
ask gemini for latest tech news

Sandbox Mode

use gemini sandbox to run @script.py
ask gemini to safely test this code
use gemini sandbox to install numpy

Tools

| Tool | Description | |:-----|:------------| | ask | Query Gemini or Codex with @ file references | | ask-gemini | Backward-compatible alias for ask | | brainstorm | Creative ideation with frameworks | | review-code | Interactive code review sessions | | ping | Connection test | | help | CLI documentation |

Parameters

ask (or ask-gemini)

prompt      Required    Analysis request with @ syntax
backend     Optional    gemini (default) | codex
model       Optional    Backend-specific override
reasoningEffort Optional Codex-only: low|medium|high|xhigh
sandbox     Optional    Gemini sandbox / Codex workspace-write
sandboxMode Optional    Codex-only: read-only|workspace-write|danger-full-access
session     Optional    Conversation continuity
includeHistory Optional Include previous rounds
changeMode  Optional    Structured edit suggestions

Links

Documentation Original Project This Fork

MIT License — Not affiliated with Google