{"_id":"@iflow-mcp/gemini-mcp-tool","_rev":"2-eac78ee3a1515f7bc5d99bf426b9a21a","name":"@iflow-mcp/gemini-mcp-tool","dist-tags":{"latest":"1.1.5"},"versions":{"1.1.4":{"name":"@iflow-mcp/gemini-mcp-tool","version":"1.1.4","keywords":["mcp","modelcontextprotocol","gemini","cli","ai","llm"],"author":{"name":"jamubc"},"license":"MIT","_id":"@iflow-mcp/gemini-mcp-tool@1.1.4","maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"homepage":"https://github.com/jamubc/gemini-mcp-tool#readme","bugs":{"url":"https://github.com/jamubc/gemini-mcp-tool/issues"},"bin":{"gemini-mcp":"dist/index.js"},"dist":{"shasum":"7d5c8243f4fc0715dbd54475881e2bdc85db24e2","tarball":"https://registry.npmjs.org/@iflow-mcp/gemini-mcp-tool/-/gemini-mcp-tool-1.1.4.tgz","fileCount":75,"integrity":"sha512-Efm1jrL+OYtVQUgmZScMCqzSCQgGkYldXVyW4aVnw3tnpkCQm2/bT0fmlMfHHjX6Hvck7oWqETxrRLhFElZoXw==","signatures":[{"sig":"MEUCIQCI/0fS6l3Mwq1J6D0Snkpj+CfwbM1kZHJq1nuzt1nHIwIgXQlhY93H3qRj0Gjs6hLCw6FkzLxJLSSwIEBpy+bOlr8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124405},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"9556b65d1aaafd5cc18aeff9382c34229f4326fd","scripts":{"dev":"tsc && node dist/index.js","lint":"tsc --noEmit","test":"echo \"No tests yet\" && exit 0","build":"tsc","start":"node dist/index.js","docs:dev":"vitepress dev docs","contribute":"tsx src/contribute.ts","docs:build":"vitepress build docs","docs:preview":"vitepress preview docs","prepublishOnly":"echo '⚠️  Remember to test locally first!' && npm run build"},"_npmUser":{"name":"qystart","email":"987472953@qq.com"},"repository":{"url":"git+https://github.com/jamubc/gemini-mcp-tool.git","type":"git"},"_npmVersion":"11.5.2","description":"MCP server for Gemini CLI integration","directories":{},"_nodeVersion":"22.17.0","dependencies":{"ai":"^4.3.17","zod":"^3.25.76","chalk":"^5.0.0","prismjs":"^1.30.0","d3-shape":"^3.2.0","inquirer":"^9.0.0","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","mermaid":"^11.9.0","archiver":"^7.0.1","vitepress":"^1.6.3","typescript":"^5.0.0","@types/node":"^20.0.0","@types/inquirer":"^9.0.0","vitepress-plugin-mermaid":"^2.0.17"},"_npmOperationalInternal":{"tmp":"tmp/gemini-mcp-tool_1.1.4_1754882255489_0.5118794335433206","host":"s3://npm-registry-packages-npm-production"}},"1.1.5":{"name":"@iflow-mcp/gemini-mcp-tool","version":"1.1.5","description":"MCP server for Gemini CLI integration","type":"module","main":"dist/index.js","bin":{"gemini-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc && node dist/index.js","test":"echo \"No tests yet\" && exit 0","lint":"tsc --noEmit","contribute":"tsx src/contribute.ts","prepublishOnly":"echo '⚠️  Remember to test locally first!' && npm run build","docs:dev":"vitepress dev docs","docs:build":"vitepress build docs","docs:preview":"vitepress preview docs"},"keywords":["mcp","modelcontextprotocol","gemini","cli","ai","llm"],"author":{"name":"jamubc"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/jamubc/gemini-mcp-tool.git"},"bugs":{"url":"https://github.com/jamubc/gemini-mcp-tool/issues"},"homepage":"https://github.com/jamubc/gemini-mcp-tool#readme","engines":{"node":">=16.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","ai":"^4.3.17","chalk":"^5.0.0","d3-shape":"^3.2.0","inquirer":"^9.0.0","prismjs":"^1.30.0","zod":"^3.25.76","zod-to-json-schema":"^3.24.6"},"devDependencies":{"@types/inquirer":"^9.0.0","@types/node":"^20.0.0","archiver":"^7.0.1","mermaid":"^11.9.0","tsx":"^4.0.0","typescript":"^5.0.0","vitepress":"^1.6.3","vitepress-plugin-mermaid":"^2.0.17"},"publishConfig":{"access":"public"},"_id":"@iflow-mcp/gemini-mcp-tool@1.1.5","gitHead":"45417b32b1bb8e812172ea06fc6b29a3e66f3ba1","types":"./dist/index.d.ts","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-MMtr2lKmu7Lz38ZUSDC1Bl/nvgjffiKlHLftC7tHSVkVnOj57+5QniG0cata1TAr1eNf5cUILJJHPEUspDHBFQ==","shasum":"945cc813e2339ff18723595b00d9752e7f60acc1","tarball":"https://registry.npmjs.org/@iflow-mcp/gemini-mcp-tool/-/gemini-mcp-tool-1.1.5.tgz","fileCount":75,"unpackedSize":124405,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDBuq9knnmZQ+KbH5xfYpPHzo1lkdRDux7FpCQzsniXcQIhAMtlJW2acLnGa9fCKmMOOcMwYBA/ujSe85rC0UtiJEF9"}]},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"directories":{},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gemini-mcp-tool_1.1.5_1762845224526_0.4087016880179255"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-11T03:17:35.404Z","modified":"2025-11-11T07:13:44.914Z","1.1.4":"2025-08-11T03:17:35.703Z","1.1.5":"2025-11-11T07:13:44.716Z"},"bugs":{"url":"https://github.com/jamubc/gemini-mcp-tool/issues"},"author":{"name":"jamubc"},"license":"MIT","homepage":"https://github.com/jamubc/gemini-mcp-tool#readme","keywords":["mcp","modelcontextprotocol","gemini","cli","ai","llm"],"repository":{"type":"git","url":"git+https://github.com/jamubc/gemini-mcp-tool.git"},"description":"MCP server for Gemini CLI integration","maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"readme":"\n# Gemini MCP Tool\n\n<div align=\"center\">\n\n[![GitHub Release](https://img.shields.io/github/v/release/jamubc/gemini-mcp-tool?logo=github&label=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</div>\n\n> 📚 **[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<a href=\"https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool/badge\" alt=\"Gemini Tool MCP server\" />\n</a>\n\n## TLDR: [![Claude](https://img.shields.io/badge/Claude-D97757?logo=claude&logoColor=fff)](#) + [![Google Gemini](https://img.shields.io/badge/Google%20Gemini-886FBF?logo=googlegemini&logoColor=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","readmeFilename":"README.md"}