快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

npx gemini-mcp-tool-windows-fixed@1.0.21

详细介绍

🚀 Gemini MCP工具-Windows固定版本

](https://badge.fury.io/js/gemini-mcp-tool-windows-fixed) ![License: MIT](https://opensource.org/licenses/MIT)

最新版本v1.0.21 -修复了跨终端兼容性问题和获取块格式错误

A. Windows兼容 模型上下文协议（MCP）服务器，使AI助手能够与谷歌的Gemini CLI进行交互。这是一个固定版本，专门设计用于在支持PowerShell的Windows环境中无缝工作。

备注：这是的增强版本原始gemini mcp工具 Windows特有的修复和改进。

🆕 最新更新（v1.0.21）

🔧 固定跨终端兼容性 -已解决的Node.js路径在不同终端环境中找不到问题
📦 修复了获取块格式错误 -修复了分块响应中MCP协议格式不匹配的问题
🛡️ 增强的PATH环境变量处理 -自动添加常见的Node.js安装路径
✅ 与所有终端完全兼容 -支持PowerShell、CMD、VS代码终端、Trae AI、CherryStudio等。
🚀 改进了错误处理 -更好的错误消息和调试输出

v1.0.3更新

🆕 PowerShell路径参数支持 -添加可选 powershellPath 允许用户自定义PowerShell可执行路径的参数
✅ 修复PowerShell执行错误 -已解决 spawn powershell.exe ENOENT 问题
✅ 改进了Windows兼容性 -自动检测可用的PowerShell版本
✅ 修复了未定义变量错误 -已修复 args 可变问题 executeCommandWithPipedInput 函数
✅ 增强的错误处理 -更好的错误消息和调试输出
✅ 向后兼容 -现有配置不需要修改，自动使用默认检测逻辑

✨ 特性

🪟 Windows兼容的：具有Windows特定路径处理的完整PowerShell支持
📊 大上下文窗口：利用Gemini庞大的令牌窗口分析整个代码库
📁 文件分析：使用分析文件 @filename 语法
🔒 沙盒模式：安全的代码执行环境
🔗 MCP集成：与MCP兼容的AI助手（Trae AI、Claude Desktop）无缝集成
⚡ NPX就绪：NPX易于安装和使用
🔧 环境变量支持：灵活的API密钥配置

此Windows固定版本解决了以下问题：

PowerShell参数传递问题
中文/Unicode文本的字符编码问题
Windows上的命令行参数转义
环境变量处理

📋 先决条件

在使用此工具之前，请确保您已：

**** （v16.0.0或更高版本）

   node --version  # Should be v16+

谷歌Gemini CLI 安装和配置

   npm install -g @google/generative-ai-cli

   # Verify installation
   gemini --version

API密钥：从获取API密钥谷歌AI工作室

📦 安装

NPX快速入门（推荐）

# Use latest version (recommended)
npx gemini-mcp-tool-windows-fixed@1.0.21

# Or use latest version tag
npx -y gemini-mcp-tool-windows-fixed@latest

全球安装

# Install latest version
npm install -g gemini-mcp-tool-windows-fixed@1.0.21

# Run the tool
gemini-mcp-tool-windows-fixed

更新现有安装

如果您之前安装了旧版本：

# Uninstall old version and install latest
npm uninstall -g gemini-mcp-tool-windows-fixed
npm cache clean --force
npm install -g gemini-mcp-tool-windows-fixed@1.0.21

⚙️ MCP客户端配置

克劳德代码（单行设置）

# One-command setup for Claude Code
claude mcp add gemini-cli -- npx -y gemini-mcp-tool-windows-fixed@1.0.21

验证安装： 类型 /mcp 在Claude Code内部验证 gemini-cli MCP处于活动状态。 1

替代方案：从Claude Desktop导入

如果您已经在Claude Desktop中配置了它：

添加到您的Claude Desktop配置中（见下文）
导入到克劳德代码：

   claude mcp add-from-claude-desktop

Trae AI（推荐）

打开： %APPDATA%\Trae\User\mcp.json
添加此配置：

{
  "mcpServers": {
    "gemini-cli": {
      "name": "gemini-cli",
      "description": "Windows-compatible Gemini MCP Tool",
      "baseUrl": "",
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool-windows-fixed@1.0.21"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_ACTUAL_API_KEY_HERE"
      },
      "isActive": true,
      "providerUrl": "https://github.com/orzcls/gemini-mcp-tool-windows-fixed"
    }
  }
}

克劳德桌面版

打开： %APPDATA%\Claude\claude_desktop_config.json
添加此配置：

{
  "mcpServers": {
    "gemini-cli": {
      "command": "npx",
      "args": ["-y", "gemini-mcp-tool-windows-fixed@1.0.21"],
      "env": {
        "GEMINI_API_KEY": "YOUR_ACTUAL_API_KEY_HERE"
      }
    }
  }
}

🔑 API密钥配置

选项1:MCP配置（推荐）

替换 YOUR_ACTUAL_API_KEY_HERE 在上面的配置中使用您的实际API密钥。

选项2：环境变量

# Temporary (current session)
$env:GEMINI_API_KEY = "your-actual-api-key"

# Permanent (user level)
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-actual-api-key", "User")

# Verify
echo $env:GEMINI_API_KEY

配置文件位置

克劳德桌面：

视窗: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

带来AI：

视窗: %APPDATA%\Trae\User\mcp.json

🛠️ 可用工具

此MCP服务器为AI助手提供以下工具：

1. `ask-gemini`

与Google Gemini互动以进行分析和提问。

参数：

prompt （必填）：分析请求。使用 @ 文件引用的语法
model （可选）：要使用的Gemini模型（默认值： gemini-2.5-pro)
sandbox （可选）：启用沙盒模式以安全执行代码
changeMode （可选）：启用结构化更改模式
chunkIndex （可选）：用于继续的块索引
chunkCacheKey （可选）：缓存键用于继续

2. `brainstorm`

使用各种头脑风暴框架产生创意。

参数：

prompt （必填）：头脑风暴挑战或问题
model （可选）：使用Gemini型号
methodology （可选）：框架(divergent, convergent, scamper, design-thinking, lateral, auto)
domain （可选）：域上下文(software, business, creative等等）
constraints （可选）：已知的限制或要求
existingContext （可选）：背景信息
ideaCount （可选）：要生成的想法数量（默认值：12）
includeAnalysis （可选）：包括可行性分析（默认值：true）

3. `fetch-chunk`

从changeMode响应中检索缓存块。

参数：

cacheKey （必需）：从初始响应中缓存密钥
chunkIndex （必填）：要检索的块索引（从1开始）

4. `timeout-test`

测试超时预防机制。

参数：

duration （必填）：持续时间（毫秒）（最小值：10ms）

5. `ping`

测试与服务器的连接。

参数：

prompt （可选）：要回显的消息

6. `Help`

显示有关可用工具的帮助信息。

🎯 使用示例

配置后，您可以通过MCP客户端使用以下工具：

自然语言示例 2

使用文件引用（使用@语法）：

“请gemini分析@src/main.js并解释它的作用”
“使用gemini来总结@。当前目录”
“分析@package.json并告诉我依赖关系”

一般问题（无文件）：

“请双子座搜索最新的科技新闻”
“使用gemini解释div中心化”
“向gemini咨询与@file_im_confused_about相关的React开发最佳实践”
“使用gemini解释index.html”
“使用gemini了解大型项目”
“请双子座搜索最新消息”

使用Gemini CLI的沙盒模式： 2 沙盒模式允许您在隔离环境中安全地测试代码更改、运行脚本或执行潜在风险的操作。

“使用gemini沙盒创建并运行处理数据的Python脚本”
“让gemini安全地测试@script.py并解释它的作用”
“使用gemini沙盒安装numpy并创建数据可视化”
“安全地测试此代码：创建一个向API发出HTTP请求的脚本”

Slash命令（适用于Claude代码用户） 2

您可以直接在Claude Code的界面中使用这些命令（尚未测试与其他客户端的兼容性）：

/分析：使用Gemini分析文件或目录，或提出一般问题

- prompt （必填）：分析提示。使用@语法来包含文件（例如。， /analyze prompt:@src/ summarize this directory)或提出一般性问题（例如。， /analyze prompt:Please use a web search to find the latest news stories)

/沙箱：在Gemini的沙盒环境中安全地测试代码或脚本

- prompt （必填）：代码测试请求（例如。， /sandbox prompt:Create and run a Python script that processes CSV data 或 /sandbox prompt:@script.py Test this script safely)

/帮助：显示Gemini CLI帮助信息

/ping：测试与服务器的连接

- message （可选）：要回显的消息

可用工具

问问双子座：向Gemini发送提示

  "Explain how MCP works"

分析文件：使用分析特定文件 @filename 语法

  "Analyze @package.json and suggest improvements"

沙盒模式：在安全的环境中执行代码

  "Run this Python code in sandbox mode: print('Hello World')"

🔧 Windows特定修复程序

此版本包括以下Windows特定的改进：

PowerShell参数处理：修复了传递参数以避免参数拆分的问题
字符编码：正确处理中文和Unicode字符的UTF-8
报价逃逸：正确转义命令参数中的引号
环境变量：改进 .env 文件加载和环境变量处理
路径解析：与Windows兼容的路径处理

🧪 测试装置

1.测试Gemini CLI

gemini -p "Hello, how are you?"

2.测试MCP工具

npx -y gemini-mcp-tool-windows-fixed
# Should show: [GMCPT] Gemini CLI MCP Server (Fixed) started

3.测试MCP集成

重新启动MCP客户端（Trae AI、Claude Desktop）
试着问：“用双子座来解释什么是MCP”
检查是否成功响应

🐛 故障排除

常见问题

“找不到命令：gemini”

npm install -g @google/generative-ai-cli

“找不到API密钥”

# Check if API key is set
echo $env:GEMINI_API_KEY

# Set if empty
$env:GEMINI_API_KEY = "your-api-key"

“权限被拒绝”

# Check execution policy
Get-ExecutionPolicy
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

有关详细的故障排除，请参阅安装指南.md.

🔧 Windows特定修复程序

此版本包括几个特定于Windows的改进：

PowerShell集成：本机PowerShell命令执行
路径处理：正确的Windows路径解析
环境变量：增强的环境变量支持
错误处理：更好的Windows环境错误消息
依赖管理：简化的依赖关系结构

🤝 贡献

欢迎投稿！拜托：

复刻仓库
创建要素分支
在Windows环境下进行测试
提交拉取请求

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

🙏 致谢

原始项目： jamubc/gemini mcp工具
谷歌Gemini CLI团队
模型上下文协议（MCP）社区

📞 支持

如果您遇到任何问题或有疑问：

检查问题页
使用有关您问题的详细信息创建新问题
包括您的Windows版本、Node.js版本和错误消息

______________________________________________________________________

由...制作❤️ 面向Windows开发人员

备注：这是原始gemini mcp工具的Windows优化分支。对于其他平台，考虑使用原始版本.

目录标签

命令行工具JavaScriptClaudeAI助手本地部署Windows兼容Gemini集成MCP协议

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

api-key

运行时（runtime，运行环境）

Node.js

部署方式（deploymentType，部署类型）

local-only

来源包（packageName，安装包名）

gemini-mcp-tool-windows-fixed@1.0.21

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdioapi-keylocal-only

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/7992e184217a8b82df78929d37620570

一个Windows兼容的模型上下文协议(MCP)服务器，使AI助手能够与Google的Gemini CLI交互。

GE

Glama

glama.ai

/mcp/servers/orzcls/gemini-mcp-tool-windows-fixed

A Windows-compatible Model Context Protocol server that enables AI assistants to interact with Google's Gemini CLI, supporting file analysis, large context windows, and safe code execution.

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Gemini MCP Server Ddb7faaa

基于Google Gemini AI的客户支持机器人，遵循MCP协议标准，提供高性能、多语言支持且完全免费的AI响应服务。

下一个 MCP

Gemini MCP Tool Windows Fixed (gemini-39cc19e5)

全面解析Gemini MCP Tool Windows FixedMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Gemini MCP Tool Windows Fixed能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

Gemini MCP Tool Windows Fixed

快速接入

详细介绍

🚀 Gemini MCP工具-Windows固定版本

🆕 最新更新（v1.0.21）

v1.0.3更新

✨ 特性

📋 先决条件

📦 安装

NPX快速入门（推荐）

全球安装

更新现有安装

⚙️ MCP客户端配置

克劳德代码（单行设置）

替代方案：从Claude Desktop导入

Trae AI（推荐）

克劳德桌面版

🔑 API密钥配置

选项1:MCP配置（推荐）

选项2：环境变量

配置文件位置

🛠️ 可用工具

1. ask-gemini

2. brainstorm

3. fetch-chunk

4. timeout-test

5. ping

6. Help

🎯 使用示例

自然语言示例 2

Slash命令（适用于Claude代码用户） 2

可用工具

🔧 Windows特定修复程序

🧪 测试装置

1.测试Gemini CLI

2.测试MCP工具

3.测试MCP集成

🐛 故障排除

常见问题

“找不到命令：gemini”

“找不到API密钥”

“权限被拒绝”

🔧 Windows特定修复程序

🤝 贡献

📄 许可证

🙏 致谢

📞 支持

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

1. `ask-gemini`

2. `brainstorm`

3. `fetch-chunk`

4. `timeout-test`

5. `ping`

6. `Help`