{"id":29131319,"url":"https://github.com/jamubc/gemini-mcp-tool","last_synced_at":"2026-01-19T21:41:51.347Z","repository":{"id":301842972,"uuid":"1010478967","full_name":"jamubc/gemini-mcp-tool","owner":"jamubc","description":"MCP server that enables AI assistants to interact with Google Gemini CLI, leveraging Gemini's massive token window for large file analysis and codebase understanding","archived":false,"fork":false,"pushed_at":"2025-11-25T11:48:56.000Z","size":909,"stargazers_count":1644,"open_issues_count":16,"forks_count":132,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-11-28T17:36:17.624Z","etag":null,"topics":["ai","claude","cli","codebase-analysis","file-analysis","gemini","mcp","model-context-protocol","npm","typescript"],"latest_commit_sha":null,"homepage":"https://jamubc.github.io/gemini-mcp-tool/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jamubc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-29T06:45:11.000Z","updated_at":"2025-11-28T16:05:51.000Z","dependencies_parsed_at":"2025-07-19T20:26:08.978Z","dependency_job_id":"7c91e567-0353-420b-8ce1-4d2c3b7ea4fa","html_url":"https://github.com/jamubc/gemini-mcp-tool","commit_stats":null,"previous_names":["jamubc/gemini-mcp-tool"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/jamubc/gemini-mcp-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgemini-mcp-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgemini-mcp-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgemini-mcp-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgemini-mcp-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamubc","download_url":"https://codeload.github.com/jamubc/gemini-mcp-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgemini-mcp-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28578951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T17:42:58.221Z","status":"ssl_error","status_checked_at":"2026-01-19T17:40:54.158Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","cli","codebase-analysis","file-analysis","gemini","mcp","model-context-protocol","npm","typescript"],"created_at":"2025-06-30T05:07:40.527Z","updated_at":"2026-01-19T21:41:51.341Z","avatar_url":"https://github.com/jamubc.png","language":"TypeScript","funding_links":[],"categories":["LLM Bridges","MCP Servers","📚 Projects (1974 total)","Gemini","TypeScript","Code Execution","Containerised MCP Servers","MCP Ecosystem","MCP Servers \u0026 Protocol"],"sub_categories":["Trading \u0026 Exchanges","MCP Servers","Laravel","How to Submit","AI \u0026 Machine Learning","Servers","Software Development"],"readme":"\n# Gemini MCP Tool\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub Release](https://img.shields.io/github/v/release/jamubc/gemini-mcp-tool?logo=github\u0026label=GitHub)](https://github.com/jamubc/gemini-mcp-tool/releases)\n[![npm version](https://img.shields.io/npm/v/gemini-mcp-tool)](https://www.npmjs.com/package/gemini-mcp-tool)\n[![npm downloads](https://img.shields.io/npm/dt/gemini-mcp-tool)](https://www.npmjs.com/package/gemini-mcp-tool)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Open Source](https://img.shields.io/badge/Open%20Source-❤️-red.svg)](https://github.com/jamubc/gemini-mcp-tool)\n\n\u003c/div\u003e\n\n\u003e 📚 **[View Full Documentation](https://jamubc.github.io/gemini-mcp-tool/)** - Search me!, Examples, FAQ, Troubleshooting, Best Practices\n\nThis is a simple Model Context Protocol (MCP) server that allows AI assistants to interact with the [Gemini CLI](https://github.com/google-gemini/gemini-cli). It enables the AI to leverage the power of Gemini's massive token window for large analysis, especially with large files and codebases using the `@` syntax for direction.\n\n- Ask gemini natural questions, through claude or Brainstorm new ideas in a party of 3!\n\n\u003ca href=\"https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool/badge\" alt=\"Gemini Tool MCP server\" /\u003e\n\u003c/a\u003e\n\n## TLDR: [![Claude](https://img.shields.io/badge/Claude-D97757?logo=claude\u0026logoColor=fff)](#) + [![Google Gemini](https://img.shields.io/badge/Google%20Gemini-886FBF?logo=googlegemini\u0026logoColor=fff)](#)\n\n\n**Goal**: Use Gemini's powerful analysis capabilities directly in Claude Code to save tokens and analyze large files.\n\n## Prerequisites\n\nBefore using this tool, ensure you have:\n\n1. **[Node.js](https://nodejs.org/)** (v16.0.0 or higher)\n2. **[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)** installed and configured\n\n\n### One-Line Setup\n\n```bash\nclaude mcp add gemini-cli -- npx -y gemini-mcp-tool\n```\n\n### Verify Installation\n\nType `/mcp` inside Claude Code to verify the gemini-cli MCP is active.\n\n---\n\n### Alternative: Import from Claude Desktop\n\nIf you already have it configured in Claude Desktop:\n\n1. Add to your Claude Desktop config:\n```json\n\"gemini-cli\": {\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"gemini-mcp-tool\"]\n}\n```\n\n2. Import to Claude Code:\n```bash\nclaude mcp add-from-claude-desktop\n```\n\n## Configuration\n\nRegister the MCP server with your MCP client:\n\n### For NPX Usage (Recommended)\n\nAdd this configuration to your Claude Desktop config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gemini-mcp-tool\"]\n    }\n  }\n}\n```\n\n### For Global Installation\n\nIf you installed globally, use this configuration instead:\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-cli\": {\n      \"command\": \"gemini-mcp\"\n    }\n  }\n}\n```\n\n**Configuration File Locations:**\n\n- **Claude Desktop**:\n  - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n  - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n  - **Linux**: `~/.config/claude/claude_desktop_config.json`\n\nAfter updating the configuration, restart your terminal session.\n\n## Example Workflow\n\n- **Natural language**: \"use gemini to explain index.html\", \"understand the massive project using gemini\", \"ask gemini to search for latest news\"\n- **Claude Code**: Type `/gemini-cli` and commands will populate in Claude Code's interface.\n\n## Usage Examples\n\n### With File References (using @ syntax)\n\n- `ask gemini to analyze @src/main.js and explain what it does`\n- `use gemini to summarize @. the current directory`\n- `analyze @package.json and tell me about dependencies`\n\n### General Questions (without files)\n\n- `ask gemini to search for the latest tech news`\n- `use gemini to explain div centering`\n- `ask gemini about best practices for React development related to @file_im_confused_about`\n\n### Using Gemini CLI's Sandbox Mode (-s)\n\nThe sandbox mode allows you to safely test code changes, run scripts, or execute potentially risky operations in an isolated environment.\n\n- `use gemini sandbox to create and run a Python script that processes data`\n- `ask gemini to safely test @script.py and explain what it does`\n- `use gemini sandbox to install numpy and create a data visualization`\n- `test this code safely: Create a script that makes HTTP requests to an API`\n\n### Tools (for the AI)\n\nThese tools are designed to be used by the AI assistant.\n\n- **`ask-gemini`**: Asks Google Gemini for its perspective. Can be used for general questions or complex analysis of files.\n  - **`prompt`** (required): The analysis request. Use the `@` syntax to include file or directory references (e.g., `@src/main.js explain this code`) or ask general questions (e.g., `Please use a web search to find the latest news stories`).\n  - **`model`** (optional): The Gemini model to use. Defaults to `gemini-2.5-pro`.\n  - **`sandbox`** (optional): Set to `true` to run in sandbox mode for safe code execution.\n- **`sandbox-test`**: Safely executes code or commands in Gemini's sandbox environment. Always runs in sandbox mode.\n  - **`prompt`** (required): Code testing request (e.g., `Create and run a Python script that...` or `@script.py Run this safely`).\n  - **`model`** (optional): The Gemini model to use.\n- **`Ping`**: A simple test tool that echoes back a message.\n- **`Help`**: Shows the Gemini CLI help text.\n\n### Slash Commands (for the User)\n\nYou can use these commands directly in Claude Code's interface (compatibility with other clients has not been tested).\n\n- **/analyze**: Analyzes files or directories using Gemini, or asks general questions.\n  - **`prompt`** (required): The analysis prompt. Use `@` syntax to include files (e.g., `/analyze prompt:@src/ summarize this directory`) or ask general questions (e.g., `/analyze prompt:Please use a web search to find the latest news stories`).\n- **/sandbox**: Safely tests code or scripts in Gemini's sandbox environment.\n  - **`prompt`** (required): Code testing request (e.g., `/sandbox prompt:Create and run a Python script that processes CSV data` or `/sandbox prompt:@script.py Test this script safely`).\n- **/help**: Displays the Gemini CLI help information.\n- **/ping**: Tests the connection to the server.\n  - **`message`** (optional): A message to echo back.\n\n## Contributing\n\nContributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n**Disclaimer:** This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by Google.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamubc%2Fgemini-mcp-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamubc%2Fgemini-mcp-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamubc%2Fgemini-mcp-tool/lists"}