[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-jamubc--gemini-mcp-tool":3,"tool-jamubc--gemini-mcp-tool":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",156804,2,"2026-04-15T11:34:33",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":74,"owner_location":74,"owner_email":74,"owner_twitter":74,"owner_website":74,"owner_url":77,"languages":78,"stars":91,"forks":92,"last_commit_at":93,"license":94,"difficulty_score":32,"env_os":95,"env_gpu":96,"env_ram":96,"env_deps":97,"category_tags":102,"github_topics":103,"view_count":32,"oss_zip_url":74,"oss_zip_packed_at":74,"status":17,"created_at":114,"updated_at":115,"faqs":116,"releases":147},7795,"jamubc\u002Fgemini-mcp-tool","gemini-mcp-tool","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","gemini-mcp-tool 是一款连接 AI 助手与 Google Gemini CLI 的桥梁工具，基于模型上下文协议（MCP）构建。它的核心作用是让 Claude 等 AI 编程助手能够直接调用 Gemini 的强大能力，特别是利用其超大的上下文窗口（Token 限额）来处理海量数据。\n\n在实际开发中，面对庞大的代码库或超长文件时，单一模型往往受限于上下文长度而难以全面理解。gemini-mcp-tool 完美解决了这一痛点，允许用户在对话中通过简单的\"@\"语法指定文件或目录，指挥 Gemini 进行深度代码分析、项目结构梳理或大文件解读，而无需消耗主助手的宝贵 Token 额度。这不仅提升了分析效率，还实现了不同 AI 模型间的优势互补。\n\n该工具主要面向软件开发者和技术研究人员，尤其是那些需要频繁处理大型项目、进行复杂代码审查或希望在工作流中整合多模型能力的进阶用户。其独特的技术亮点在于无缝集成了 Gemini CLI 的沙箱模式与自然语言交互能力，让用户能在熟悉的聊天界面中，以极低的配置成本享受到企业级的长文本分析服务。只需一行命令即可完成安装，是提升现代开发效率的实用利","gemini-mcp-tool 是一款连接 AI 助手与 Google Gemini CLI 的桥梁工具，基于模型上下文协议（MCP）构建。它的核心作用是让 Claude 等 AI 编程助手能够直接调用 Gemini 的强大能力，特别是利用其超大的上下文窗口（Token 限额）来处理海量数据。\n\n在实际开发中，面对庞大的代码库或超长文件时，单一模型往往受限于上下文长度而难以全面理解。gemini-mcp-tool 完美解决了这一痛点，允许用户在对话中通过简单的\"@\"语法指定文件或目录，指挥 Gemini 进行深度代码分析、项目结构梳理或大文件解读，而无需消耗主助手的宝贵 Token 额度。这不仅提升了分析效率，还实现了不同 AI 模型间的优势互补。\n\n该工具主要面向软件开发者和技术研究人员，尤其是那些需要频繁处理大型项目、进行复杂代码审查或希望在工作流中整合多模型能力的进阶用户。其独特的技术亮点在于无缝集成了 Gemini CLI 的沙箱模式与自然语言交互能力，让用户能在熟悉的聊天界面中，以极低的配置成本享受到企业级的长文本分析服务。只需一行命令即可完成安装，是提升现代开发效率的实用利器。","\n# Gemini MCP Tool\n\n\u003Cdiv align=\"center\">\n\n[![GitHub Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fjamubc\u002Fgemini-mcp-tool?logo=github&label=GitHub)](https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Freleases)\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fgemini-mcp-tool)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgemini-mcp-tool)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdt\u002Fgemini-mcp-tool)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgemini-mcp-tool)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Open Source](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen%20Source-❤️-red.svg)](https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool)\n\n\u003C\u002Fdiv>\n\n> 📚 **[View Full Documentation](https:\u002F\u002Fjamubc.github.io\u002Fgemini-mcp-tool\u002F)** - 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:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-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:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002F@jamubc\u002Fgemini-mcp-tool\">\n  \u003Cimg width=\"380\" height=\"200\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjamubc_gemini-mcp-tool_readme_53a10ec03884.png\" alt=\"Gemini Tool MCP server\" \u002F>\n\u003C\u002Fa>\n\n## TLDR: [![Claude](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude-D97757?logo=claude&logoColor=fff)](#) + [![Google Gemini](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGoogle%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:\u002F\u002Fnodejs.org\u002F)** (v16.0.0 or higher)\n2. **[Google Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-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 `\u002Fmcp` 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**: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n  - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n  - **Linux**: `~\u002F.config\u002Fclaude\u002Fclaude_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 `\u002Fgemini-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\u002Fmain.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\u002Fmain.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- **\u002Fanalyze**: Analyzes files or directories using Gemini, or asks general questions.\n  - **`prompt`** (required): The analysis prompt. Use `@` syntax to include files (e.g., `\u002Fanalyze prompt:@src\u002F summarize this directory`) or ask general questions (e.g., `\u002Fanalyze prompt:Please use a web search to find the latest news stories`).\n- **\u002Fsandbox**: Safely tests code or scripts in Gemini's sandbox environment.\n  - **`prompt`** (required): Code testing request (e.g., `\u002Fsandbox prompt:Create and run a Python script that processes CSV data` or `\u002Fsandbox prompt:@script.py Test this script safely`).\n- **\u002Fhelp**: Displays the Gemini CLI help information.\n- **\u002Fping**: 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","# Gemini MCP 工具\n\n\u003Cdiv align=\"center\">\n\n[![GitHub 发布](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fjamubc\u002Fgemini-mcp-tool?logo=github&label=GitHub)](https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Freleases)\n[![npm 版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fgemini-mcp-tool)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgemini-mcp-tool)\n[![npm 下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdt\u002Fgemini-mcp-tool)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgemini-mcp-tool)\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![开源](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen%20Source-❤️-red.svg)](https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool)\n\n\u003C\u002Fdiv>\n\n> 📚 **[查看完整文档](https:\u002F\u002Fjamubc.github.io\u002Fgemini-mcp-tool\u002F)** - 搜索我！示例、常见问题解答、故障排除、最佳实践\n\n这是一个简单的模型上下文协议（MCP）服务器，允许 AI 助手与 [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) 交互。它使 AI 能够利用 Gemini 海量的上下文窗口进行大规模分析，尤其是在处理大型文件和代码库时，可以使用 `@` 语法来指定方向。\n\n- 通过 Claude 向 Gemini 提出自然问题，或在三人小组中一起头脑风暴新想法！\n\n\u003Ca href=\"https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002F@jamubc\u002Fgemini-mcp-tool\">\n  \u003Cimg width=\"380\" height=\"200\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjamubc_gemini-mcp-tool_readme_53a10ec03884.png\" alt=\"Gemini 工具 MCP 服务器\" \u002F>\n\u003C\u002Fa>\n\n## 简要说明：[![Claude](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude-D97757?logo=claude&logoColor=fff)](#) + [![Google Gemini](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGoogle%20Gemini-886FBF?logo=googlegemini&logoColor=fff)](#)\n\n\n**目标**：直接在 Claude Code 中使用 Gemini 强大的分析能力，以节省 token 并分析大型文件。\n\n## 先决条件\n\n在使用此工具之前，请确保您已安装以下内容：\n\n1. **[Node.js](https:\u002F\u002Fnodejs.org\u002F)**（v16.0.0 或更高版本）\n2. **[Google Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli)** 已安装并配置好\n\n\n### 一行设置\n\n```bash\nclaude mcp add gemini-cli -- npx -y gemini-mcp-tool\n```\n\n### 验证安装\n\n在 Claude Code 中输入 `\u002Fmcp`，以验证 gemini-cli MCP 是否已激活。\n\n---\n\n### 替代方案：从 Claude Desktop 导入\n\n如果您已经在 Claude Desktop 中进行了配置：\n\n1. 将以下内容添加到您的 Claude Desktop 配置中：\n```json\n\"gemini-cli\": {\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"gemini-mcp-tool\"]\n}\n```\n\n2. 导入到 Claude Code：\n```bash\nclaude mcp add-from-claude-desktop\n```\n\n## 配置\n\n将 MCP 服务器注册到您的 MCP 客户端：\n\n### 对于 NPX 使用（推荐）\n\n将以下配置添加到您的 Claude Desktop 配置文件中：\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gemini-mcp-tool\"]\n    }\n  }\n}\n```\n\n### 对于全局安装\n\n如果您已全局安装，则使用以下配置代替：\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-cli\": {\n      \"command\": \"gemini-mcp\"\n    }\n  }\n}\n```\n\n**配置文件位置：**\n\n- **Claude Desktop**：\n  - **macOS**：`~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n  - **Windows**：`%APPDATA%\\Claude\\claude_desktop_config.json`\n  - **Linux**：`~\u002F.config\u002Fclaude\u002Fclaude_desktop_config.json`\n\n更新配置后，请重新启动终端会话。\n\n## 示例工作流程\n\n- **自然语言**：“使用 Gemini 解释 index.html”，“用 Gemini 理解这个庞大的项目”，“让 Gemini 搜索最新新闻”\n- **Claude Code**：输入 `\u002Fgemini-cli`，命令将出现在 Claude Code 的界面中。\n\n## 使用示例\n\n### 带文件引用（使用 @ 语法）\n\n- “让 Gemini 分析 @src\u002Fmain.js 并解释其作用”\n- “使用 Gemini 概括 @ 当前目录”\n- “分析 @package.json 并告诉我依赖关系”\n\n### 一般问题（不带文件）\n\n- “让 Gemini 搜索最新的科技新闻”\n- “用 Gemini 解释 div 居中”\n- “让 Gemini 介绍与 @file_im_confused_about 相关的 React 开发最佳实践”\n\n### 使用 Gemini CLI 的沙盒模式 (-s)\n\n沙盒模式允许您在隔离环境中安全地测试代码更改、运行脚本或执行潜在风险操作。\n\n- “使用 Gemini 沙盒创建并运行一个处理数据的 Python  script”\n- “让 Gemini 安全地测试 @script.py 并解释其作用”\n- “使用 Gemini 沙盒安装 numpy 并创建数据可视化”\n- “安全地测试这段代码：创建一个向 API 发送 HTTP 请求的脚本”\n\n### 工具（供 AI 使用）\n\n这些工具专为 AI 助手设计。\n\n- **`ask-gemini`**：向 Google Gemini 询问其观点。可用于一般性问题或对文件的复杂分析。\n  - **`prompt`**（必填）：分析请求。使用 `@` 语法包含文件或目录引用（例如 `@src\u002Fmain.js 解释这段代码`），或提出一般性问题（例如 `请使用网络搜索查找最新新闻故事`）。\n  - **`model`**（可选）：要使用的 Gemini 模型。默认为 `gemini-2.5-pro`。\n  - **`sandbox`**（可选）：设置为 `true` 以在沙盒模式下运行，从而安全执行代码。\n- **`sandbox-test`**：在 Gemini 的沙盒环境中安全地执行代码或命令。始终在沙盒模式下运行。\n  - **`prompt`**（必填）：代码测试请求（例如 `创建并运行一个处理数据的 Python 脚本` 或 `@script.py 安全地运行此脚本`）。\n  - **`model`**（可选）：要使用的 Gemini 模型。\n- **`Ping`**：一个简单的测试工具，用于回显消息。\n- **`Help`**：显示 Gemini CLI 的帮助文本。\n\n### 斜杠命令（供用户使用）\n\n您可以在 Claude Code 的界面中直接使用这些命令（与其他客户端的兼容性尚未测试）。\n\n- **\u002Fanalyze**：使用 Gemini 分析文件或目录，或提出一般性问题。\n  - **`prompt`**（必填）：分析提示。使用 `@` 语法包含文件（例如 `\u002Fanalyze prompt:@src\u002F 概括此目录`）或提出一般性问题（例如 `\u002Fanalyze prompt:请使用网络搜索查找最新新闻故事`）。\n- **\u002Fsandbox**：在 Gemini 的沙盒环境中安全地测试代码或脚本。\n  - **`prompt`**（必填）：代码测试请求（例如 `\u002Fsandbox prompt:创建并运行一个处理 CSV 数据的 Python 脚本` 或 `\u002Fsandbox prompt:@script.py 安全地测试此脚本`）。\n- **\u002Fhelp**：显示 Gemini CLI 的帮助信息。\n- **\u002Fping**：测试与服务器的连接。\n  - **`message`**（可选）：要回显的消息。\n\n## 贡献\n\n欢迎贡献！请参阅我们的 [贡献指南](CONTRIBUTING.md)，了解如何提交拉取请求、报告问题以及参与项目。\n\n## 许可证\n\n本项目采用 MIT 许可证授权。详细信息请参阅 [LICENSE](LICENSE) 文件。\n\n**免责声明**：这是一款非官方的第三方工具，与 Google 无关联、未获其认可或赞助。","# Gemini MCP Tool 快速上手指南\n\nGemini MCP Tool 是一个简单的模型上下文协议（MCP）服务器，旨在让 AI 助手（如 Claude Code）能够直接调用 [Google Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli)。利用 Gemini 强大的长上下文窗口能力，它可以高效分析大型文件、代码库或执行复杂任务。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n1.  **Node.js**: 版本需为 v16.0.0 或更高。\n    *   国内用户推荐使用 [cnpm](https:\u002F\u002Fnpmmirror.com\u002F) 或配置 npm 镜像源加速安装。\n2.  **Google Gemini CLI**: 必须已安装并完成配置（包含有效的 API Key）。\n    *   安装命令：`npm install -g @google\u002Fgemini-cli` (需确保网络通畅或使用代理)。\n\n## 安装步骤\n\n### 方式一：一键安装（推荐）\n\n如果您使用的是 **Claude Code**，可以直接运行以下命令将工具注册到 MCP 列表中：\n\n```bash\nclaude mcp add gemini-cli -- npx -y gemini-mcp-tool\n```\n\n### 方式二：手动配置 Claude Desktop\n\n如果您需要手动编辑配置文件，请按以下步骤操作：\n\n1.  找到配置文件 `claude_desktop_config.json`：\n    *   **macOS**: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n    *   **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n    *   **Linux**: `~\u002F.config\u002Fclaude\u002Fclaude_desktop_config.json`\n\n2.  在 `mcpServers` 字段中添加以下配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gemini-mcp-tool\"]\n    }\n  }\n}\n```\n\n3.  保存文件并重启终端或 Claude 应用。\n\n### 验证安装\n\n在 Claude Code 界面中输入 `\u002Fmcp`，确认 `gemini-cli` 出现在活跃服务器列表中。\n\n## 基本使用\n\n安装完成后，您可以在对话中直接使用自然语言指令，或通过斜杠命令调用 Gemini 的能力。\n\n### 1. 自然语言交互\n\n直接在对话框中输入指令，利用 `@` 符号引用文件或目录：\n\n*   **分析特定文件**：\n    ```text\n    ask gemini to analyze @src\u002Fmain.js and explain what it does\n    ```\n*   **总结当前目录**：\n    ```text\n    use gemini to summarize @. the current directory\n    ```\n*   **通用问题查询**：\n    ```text\n    ask gemini to search for the latest tech news\n    ```\n\n### 2. 使用斜杠命令\n\n在 Claude Code 界面中，可以使用以下专用命令：\n\n*   **分析文件 (`\u002Fanalyze`)**：\n    ```text\n    \u002Fanalyze prompt:@package.json tell me about dependencies\n    ```\n*   **沙箱测试 (`\u002Fsandbox`)**：\n    安全地运行代码或脚本（隔离环境）：\n    ```text\n    \u002Fsandbox prompt:Create and run a Python script that processes data\n    ```\n    或测试现有文件：\n    ```text\n    \u002Fsandbox prompt:@script.py Test this script safely\n    ```\n\n### 3. 高级功能：沙箱模式\n\n通过指定 `sandbox` 参数或使用 `\u002Fsandbox` 命令，您可以在安全隔离的环境中让 Gemini 执行代码、安装依赖或进行网络请求，无需担心本地环境受损。\n\n> **注意**：本工具为第三方开源项目，非 Google 官方出品。使用时请妥善保管您的 API Key。","一位全栈开发者正在使用 Claude Code 重构一个包含数千个文件的遗留电商项目，急需理解复杂的业务逻辑和依赖关系。\n\n### 没有 gemini-mcp-tool 时\n- **上下文窗口受限**：Claude 自身的 Token 限制导致无法一次性读入大型核心文件（如 `legacy_order_processor.js`），只能分段读取，极易丢失全局逻辑关联。\n- **分析成本高昂**：为了理清模块间的调用链，开发者需反复手动复制粘贴代码片段进行询问，消耗大量输入 Token 且效率低下。\n- **操作割裂繁琐**：若想利用 Google Gemini 的超长上下文能力，必须切换终端运行独立的 Gemini CLI，打断在 Claude 中的心流，无法实现“一站式”协作。\n- **深层依赖盲区**：面对整个项目目录（`@.`）的宏观架构提问，传统方式难以提供精准的全局视图，导致重构方案往往顾此失彼。\n\n### 使用 gemini-mcp-tool 后\n- **海量文件一键吞吐**：直接在 Claude 对话框中输入 `ask gemini to analyze @src\u002Flegacy_order_processor.js`，即可调用 Gemini 的百万级 Token 窗口，瞬间完整解析超大文件。\n- **智能路由省资源**：复杂的大规模代码库理解任务自动交由 Gemini 处理，仅将结论返回给 Claude，大幅节省了昂贵的推理 Token 配额。\n- **无缝原生体验**：无需离开当前界面或切换工具，通过 `\u002Fgemini-cli` 指令即可在 Claude Code 内部直接调度 Gemini 能力，保持开发思路连贯。\n- **全局架构透视**：使用 `use gemini to summarize @.` 命令，让 Gemini 扫描整个项目目录，快速输出清晰的依赖图谱和重构建议，消除盲点。\n\ngemini-mcp-tool 的核心价值在于打破了模型间的壁垒，让开发者能在熟悉的 Claude 环境中直接驾驭 Gemini 的超长上下文能力，以最低成本解决大规模代码库的理解难题。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjamubc_gemini-mcp-tool_217bd033.png","jamubc",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fjamubc_0b634700.png","i study electrical things and i make stuff sometimes too","https:\u002F\u002Fgithub.com\u002Fjamubc",[79,83,87],{"name":80,"color":81,"percentage":82},"TypeScript","#3178c6",76.1,{"name":84,"color":85,"percentage":86},"Shell","#89e051",12.3,{"name":88,"color":89,"percentage":90},"JavaScript","#f1e05a",11.5,2157,184,"2026-04-15T07:24:33","NOASSERTION","macOS, Windows, Linux","未说明",{"notes":98,"python":96,"dependencies":99},"该工具是一个基于 Node.js 的 MCP 服务器，用于连接 AI 助手（如 Claude）与 Google Gemini CLI。主要依赖 Node.js (v16+) 和已配置好的 Google Gemini CLI。无需本地 GPU 或 Python 环境，但需要有效的 Google API 密钥以使用 Gemini 服务。可通过 npx 直接运行或全局安装。",[100,101],"Node.js >= 16.0.0","Google Gemini CLI",[13,52,15,14],[104,105,106,107,108,109,110,111,112,113],"ai","claude","cli","codebase-analysis","file-analysis","gemini","mcp","model-context-protocol","npm","typescript","2026-03-27T02:49:30.150509","2026-04-16T01:45:07.147622",[117,122,127,132,137,142],{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},34911,"在 Windows 上使用时遇到 'Error: spawn gemini ENOENT' 错误怎么办？","该问题已在版本 1.1.5 中修复。错误原因是 Windows 系统缺少对 .cmd 扩展名的处理及 shell 执行配置。请运行以下命令更新到最新版本：\nnpm install -g gemini-mcp-tool@latest\n如果问题依旧，请确保您的 Node.js 环境已正确配置 PATH 变量。","https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Fissues\u002F18",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},34912,"如何在 MCP 调用中启用 YOLO 模式（自动接受工具调用）？","无需在命令行添加参数，只需修改配置文件即可启用自动接受工具功能。请编辑 ~\u002F.gemini\u002Fsettings.json 文件，添加或修改以下配置：\n{\n  \"tools\": {\n    \"autoAccept\": true\n  }\n}\n保存后重启服务即可生效，这样 Gemini 将自动执行工具调用而不会卡住等待确认。","https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Fissues\u002F42",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},34913,"在使用 ask-gemini 工具分析大型代码库时频繁超时怎么办？","该问题已在版本 1.1.3 至 1.1.5 之间得到解决。新版本移除了硬编码的 5 分钟超时限制，并增加了自动回退到 Flash 模型的机制。此外，后续更新将支持通过环境变量 MCP_TIMEOUT 进行更精细的配置。请务必升级到最新版本：\nnpm install -g gemini-mcp-tool@latest","https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Fissues\u002F5",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},34914,"在 Claude Code 中运行时提示 'Connection closed' 或无法加载 MCP 服务器如何解决？","此连接关闭错误（MCP error -32000）已在版本 1.1.5 中修复。该问题通常发生在 Windows 环境下与 Claude Code 集成时。请将工具升级到最新版本以解决兼容性问题：\nnpm install -g gemini-mcp-tool@latest","https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Fissues\u002F9",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},34915,"如何更改默认使用的 Gemini 模型版本？","虽然文档默认提及 gemini-2.5-pro，但您可以指定使用更新的模型（如 gemini-3-pro-preview 或最新的 gemini-3-1-pro-preview）。具体设置方法取决于您的 MCP 客户端配置，通常在初始化 MCP Server 时通过 'model' 参数指定。例如，在配置文件中将 model 字段设置为您想要的模型字符串即可。","https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Fissues\u002F51",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},34916,"遇到 'Gemini was thinking but got cut off'（Gemini 思考被截断）的错误如何处理？","这通常是由超时设置引起的。该问题已在版本 1.1.4 中修复，优化了超时处理逻辑。如果您仍在使用旧版本，请升级以解决此问题：\nnpm install -g gemini-mcp-tool@latest\n升级后，工具将能更好地处理长耗时任务而不会被意外截断。","https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool\u002Fissues\u002F11",[148],{"id":149,"version":150,"summary_zh":151,"released_at":152},272237,"v1.1.2","## 变更内容\n- 当配额超出时，自动从 gemini-2.5-pro 回退到 gemini-2.5-flash\n\n请参阅 [README](https:\u002F\u002Fgithub.com\u002Fjamubc\u002Fgemini-mcp-tool#readme) 以获取安装和使用说明。","2025-07-13T11:03:20"]