npm package: @maxanatsko/gemini-mcp-tool
Description: MCP server for AI CLI integration (Gemini CLI + Codex CLI)
Author: maxanatsko
Latest version: 3.0.5
Deprecated: Renamed to @maxanatsko/llm-cli-bridge. Please update your configuration.

# AI CLI MCP Server

<br>

```
┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   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       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

<br>

**Version** `3.0.0`
**License** `MIT`

---

<br>

## Prerequisites

```
Node.js ≥ 16.0.0
Google Gemini CLI (configured)
```

<br>

---

<br>

## Installation

<br>

### Recommended

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

<br>

### Local Development

```bash
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
```

<br>

### Verify

```bash
/mcp
```

<br>

---

<br>

## Configuration

<br>

### Claude Desktop

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

<br>

### 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
```

<br>

---

<br>

## Usage

<br>

### File Analysis

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

<br>

### General Questions

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

<br>

### Sandbox Mode

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

<br>

---

<br>

## Tools

<br>

| 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 |

<br>

### Parameters

<br>

**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
```

<br>

---

<br>

## Links

<br>

[Documentation](https://maxanatsko.github.io/ai-cli-mcp-server/)
[Original Project](https://github.com/jamubc/gemini-mcp-tool)
[This Fork](https://github.com/maxanatsko/ai-cli-mcp-server)

<br>

---

<br>

<sub>MIT License — Not affiliated with Google</sub>