双子座-MCP工具-Windows固定版

Name: 双子座-MCP工具-Windows固定版
Author: orzcls

作者：orzcls3 星标更新：2025-08-05

安装使用来源：spider==github.com

项目介绍

🚀 Gemini MCP 工具 - Windows 固定版本

最新版本 v1.0.21 - 解决了跨终端兼容性问题和 fetch-chunk 格式错误

这是一个与 Windows 兼容的模型上下文协议 (MCP) 服务器，使AI助手能够与 Google 的 Gemini CLI 进行交互。这是专门为在 Windows 环境中无缝运行而设计的固定版本，并支持 PowerShell。

注意：这是对原始 gemini-mcp-tool 的增强版本，针对 Windows 进行了特定修复和改进。

🆕 最新更新 (v1.0.21)

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

v1.0.3 更新

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

✨ 功能

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

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

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

📋 先决条件

在使用此工具之前，请确保您已具备以下条件：

Node.js (v1.6.0 或更高版本)
```
node --version  # 应该是 v16+
```

Google Gemini CLI 已安装并配置好

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

# 验证安装
gemini --version

API 密钥：从 Google AI Studio 获取您的 API 密钥

📦 安装

快速启动（推荐）

# 使用最新版本（推荐）
npx gemini-mcp-tool-windows-fixed@1.0.21

# 或使用最新版本标签
npx -y gemini-mcp-tool-windows-fixed@latest

全局安装

# 安装最新版本
npm install -g gemini-mcp-tool-windows-fixed@1.0.21

# 运行工具
gemini-mcp-tool-windows-fixed

更新现有安装

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

# 卸载旧版本并安装最新版本
npm uninstall -g gemini-mcp-tool-windows-fixed
npm cache clean --force
npm install -g gemini-mcp-tool-windows-fixed@1.0.21

⚙️ MCP 客户端配置

Claude Code（单行设置）

# Claude Code 的单命令设置
claude mcp add gemini-cli -- npx -y gemini-mcp-tool-windows-fixed@1.0.21

验证安装：在 Claude Code 中键入 /mcp 来验证 gemini-cli MCP 是否处于活动状态。<mcreference link="https://github.com/jamubc/gemini-mcp-tool" index="1">1</mcreference>

替代方案：从 Claude Desktop 导入

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

在您的 Claude Desktop 配置中添加（见下文）
导入到 Claude Code：
```
claude mcp add-from-claude-desktop
```

Trae AI（推荐）

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

{
  "mcpServers": {
    "gemini-cli": {
      "name": "gemini-cli",
      "description": "Windows 兼容的 Gemini MCP 工具",
      "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"
    }
  }
}

Claude Desktop

打开：%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：环境变量

# 临时（当前会话）
$env:GEMINI_API_KEY = "your-actual-api-key"

# 永久（用户级别）
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-actual-api-key", "User")

# 验证
echo $env:GEMINI_API_KEY

配置文件位置

Claude Desktop：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Linux：~/.config/claude/claude_desktop_config.json

Trae AI：

Windows：%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. `帮助`

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

🎯 使用示例

一旦配置完成，您可以通过您的 MCP 客户端使用以下工具：

自然语言示例 <mcreference link="https://github.com/jamubc/gemini-mcp-tool" index="2">2</mcreference>

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

"请 Gemini 分析 @src/main.js 并解释它做了什么"
"使用 Gemini 概述 @. 当前目录"
"分析 @package.json 并告诉我关于依赖项的信息"

一般问题（无文件）：

"请 Gemini 搜索最新的科技新闻"
"使用 Gemini 解释 div 居中"
"请 Gemini 关于与 @file_im_confused_about 相关的最佳实践"
"使用 Gemini 解释 index.html"
"使用 Gemini 理解这个庞大的项目"
"请 Gemini 搜索最新的新闻"

使用 Gemini CLI 的沙箱模式（-s）：<mcreference link="https://github.com/jamubc/gemini-mcp-tool" index="2">2</mcreference> 沙箱模式允许您在一个隔离的环境中安全地测试代码更改、运行脚本或执行潜在风险的操作。

"使用 Gemini 沙箱创建并运行一个处理数据的 Python 脚本"
"请 Gemini 安全地测试 @script.py 并解释它做了什么"
"使用 Gemini 沙箱安装 numpy 并创建数据可视化"
"安全地测试这段代码：创建一个向 API 发送 HTTP 请求的脚本"

斜杠命令（适用于 Claude Code 用户）<mcreference link="https://github.com/jamubc/gemini-mcp-tool" index="2">2</mcreference>

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

/analyze：使用 Gemini 分析文件或目录，或提出一般问题
- prompt（必需）：分析提示。使用 @ 语法包含文件（例如，/analyze prompt:@src/ 概述这个目录）或提出一般问题（例如，/analyze prompt:请使用网络搜索查找最新的新闻故事）
/sandbox：在 Gemini 的沙箱环境中安全地测试代码或脚本
- prompt（必需）：代码测试请求（例如，/sandbox prompt:创建并运行一个处理 CSV 数据的 Python 脚本 或 /sandbox prompt:@script.py 安全地测试这个脚本）
/帮助：显示 Gemini CLI 的帮助信息
/ping：测试与服务器的连接
- message（可选）：要回显的消息

可用工具

ask-gemini：发送提示给 Gemini
```
"解释 MCP 是如何工作的"
```
analyze-file：使用 @filename 语法分析特定文件
```
"分析 @package.json 并提出改进建议"
```

sandbox-mode：在安全环境中执行代码

"在沙箱模式下运行这段 Python 代码：print('Hello World')"

🔧 Windows 特定修复

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

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

🧪 测试安装

1. 测试 Gemini CLI

gemini -p "你好，你好吗？"

2. 测试 MCP 工具

npx -y gemini-mcp-tool-windows-fixed
# 应显示：[GMCPT] Gemini CLI MCP 服务器（固定版）已启动

3. 测试 MCP 集成

重启您的 MCP 客户端（Trae AI、Claude Desktop）
尝试提问："请 Gemini 解释什么是 MCP"
检查是否有成功的响应

🐛 故障排除

常见问题

"找不到命令：gemini"

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

"未找到 API 密钥"

# 检查 API 密钥是否已设置
echo $env:GEMINI_API_KEY

# 如果为空则设置
$env:GEMINI_API_KEY = "your-api-key"

"权限被拒绝"

# 检查执行策略
Get-ExecutionPolicy
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

对于详细的故障排除，请参阅 INSTALL-GUIDE.md。

🔧 Windows 特定修复

此版本包括多个 Windows 特定改进：

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

🤝 贡献

欢迎贡献！请：

分叉仓库
创建功能分支
在 Windows 环境中进行测试
提交拉取请求

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

原始项目：jamubc/gemini-mcp-tool
Google Gemini CLI 团队
模型上下文协议 (MCP) 社区

📞 支持

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

查看 Issues 页面
创建一个新的问题，提供详细的问题信息
包括您的 Windows 版本、Node.js 版本和错误消息

为 Windows 开发者制作 ❤️

注意：这是原始 gemini-mcp-tool 的 Windows 优化分叉。对于其他平台，请考虑使用原始版本。

双子座-MCP工具-Windows固定版

项目介绍

🚀 Gemini MCP 工具 - Windows 固定版本

🆕 最新更新 (v1.0.21)

v1.0.3 更新

✨ 功能

📋 先决条件

📦 安装

快速启动（推荐）

全局安装

更新现有安装

⚙️ MCP 客户端配置

Claude Code（单行设置）

替代方案：从 Claude Desktop 导入

Trae AI（推荐）

Claude Desktop

🔑 API 密钥配置

选项 1：MCP 配置（推荐）

选项 2：环境变量

配置文件位置

🛠️ 可用工具

1. ask-gemini

2. brainstorm

3. fetch-chunk

4. timeout-test

5. ping

6. 帮助

🎯 使用示例

自然语言示例 <mcreference link="https://github.com/jamubc/gemini-mcp-tool" index="2">2</mcreference>

斜杠命令（适用于 Claude Code 用户）<mcreference link="https://github.com/jamubc/gemini-mcp-tool" index="2">2</mcreference>

可用工具

🔧 Windows 特定修复

🧪 测试安装

1. 测试 Gemini CLI

2. 测试 MCP 工具

3. 测试 MCP 集成

🐛 故障排除

常见问题

"找不到命令：gemini"

"未找到 API 密钥"

"权限被拒绝"

🔧 Windows 特定修复

🤝 贡献

📄 许可证

🙏 致谢

📞 支持

1. `ask-gemini`

2. `brainstorm`

3. `fetch-chunk`

4. `timeout-test`

5. `ping`

6. `帮助`