Skip to main content
Glama
chaodongzhang

gemini-cli-bridge

by chaodongzhang
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GEMINI_BRIDGE_MAX_OUTNoUnified output truncation length. Default 200000.200000
GEMINI_BRIDGE_EXTRA_PATHSNoColon-separated directories to append to PATH.
GEMINI_BRIDGE_DEFAULT_TIMEOUT_SNoDefault timeout when a tool arg timeout_s is not provided.
GEMINI_BRIDGE_ALLOWED_PATH_PREFIXESNoColon-separated safe prefixes that extra paths must reside under. Defaults include /opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/sbin.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
gemini_promptC

Run local gemini CLI non-interactively; return structured JSON.

gemini_versionB

Return installed gemini CLI version (gemini --version) as JSON.

gemini_mcp_listB

List MCP servers configured in gemini CLI (gemini mcp list). Scope: user|project.

gemini_mcp_addB

Add an MCP server via gemini CLI (gemini mcp add ...). transport: stdio|http|sse; for stdio pass executable, for http/sse pass URL. headers are only valid for http/sse. Returns CLI stdout.

gemini_mcp_removeB

Remove an MCP server from gemini CLI (gemini mcp remove ).

gemini_web_fetchC

Convenience wrapper: inject URLs into prompt to trigger CLI WebFetch. Note: WebFetch is a CLI built-in; the model decides whether to call it.

gemini_extensions_listB

List available Gemini CLI extensions (gemini --list-extensions).

gemini_prompt_plusC

Advanced non-interactive run with attachments/approval/checkpoint/dirs/flags.

  • attachments: file/dir paths appended as @path at the end of prompt.

  • approval_mode: default|auto_edit|yolo; if unset and yolo=True, add --yolo.

gemini_searchC

Lightweight search: guide the model to use built-in GoogleSearch and cite sources. Note: tool invocation is model-driven; default yolo=True to avoid interactive prompts.

gemini_prompt_with_memoryC

Inject memory_paths as high-priority context, then run non-interactively.

  • memory_paths: authoritative project/system memory (e.g., GEMINI.md, conventions).

  • attachments: additional files/dirs injected as @path.

ShellB

Execute a shell command; return JSON {code, stdout, stderr}. Disabled by default; set MCP_BASH_ALLOW=1 to enable.

FindFilesC

Find files; return JSON array of paths. Supports recursion.

ReadFileB

Read a text file (utf-8, ignore errors). Raises if missing.

ReadFolderC

Read a directory; return JSON array of entries (optionally recursive).

ReadManyFilesC

Read multiple files; return JSON object {path: content}.

SaveMemoryC

Save content to path; mode=append|overwrite; return JSON {ok, bytes}.

SearchTextC

Search text within a file; return JSON array [{line, text}].

WriteFileB

Write a UTF-8 text file, creating parents as needed. Return "ok".

EditC

String replace; count=0 means replace all. Return JSON {"replaced": n}.

WebFetchB

Minimal web fetch using the requests library; return JSON {ok,status,content?,error?}.

GoogleSearchA

Search tool (defaults to Gemini CLI built-in GoogleSearch).

Modes:

  • mode="gemini_cli": force CLI built-in (no keys; requires signed-in gemini CLI)

  • mode="gcs": force Google Programmable Search (requires GOOGLE_CSE_ID + GOOGLE_API_KEY)

  • mode=None/"auto": auto-select (use gcs if both keys present, else gemini_cli)

Returns JSON:

  • gemini_cli: { ok: true, mode: "gemini_cli", answer: string }

  • gcs: { ok: true, mode: "gcs", results: [{title, link, snippet}] } on error: { ok: false, error, results? }

GeminiGoogleSearchC

Alias to GoogleSearch to avoid tool name collisions in some IDEs.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

C2.9/5.0

Scored across 22 tools

Disambiguation3/5

Several tool families overlap: gemini_prompt/plus/with_memory, gemini_search/GoogleSearch/GeminiGoogleSearch, and WebFetch/gemini_web_fetch. Descriptions distinguish intended use cases, but an agent still faces non-trivial selection among prompt and search variants.

Naming Consistency3/5

Names split into a snake_case gemini_* family for CLI operations and a PascalCase family for local file/search/shell tools. This is readable but not a single predictable convention.

Tool Count3/5

22 tools is on the heavy side for a CLI bridge, spanning CLI invocation, MCP management, search, file I/O, memory, and shell. The surface is broad but many tools earn their place.

Completeness4/5

Core bridge operations are covered: prompt execution, MCP add/list/remove, version/extensions, search/fetch, file read/write/search/find, memory, and shell. Minor gaps like file deletion/move or MCP update are workaroundable via shell or overwrite.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources