Gemforge MCP

🚀 GemForge (Gemini工具)

GemForge 是一款企业级工具，可将Google的Gemini AI与MCP生态系统完美集成，为Claude、Roo Code和Windsurf等代理赋予强大功能，支持代码库分析、实时搜索、文本/PDF/图像处理等。

🚀 快速开始

一键安装

npx @gemforge/mcp-server@latest init

手动设置

1. 创建配置文件 (claude_desktop_config.json)：

{
  "mcpServers": {
    "GemForge": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. 安装并运行：

npm install gemforge-mcp
npm start

观看30秒设置演示 →

✨ 主要特性

• 实时网络访问：使用 gemini_search 抓取突发新闻、市场趋势和当前数据。
• 高级推理：通过 gemini_reason 以逐步思考的方式处理复杂逻辑问题。
• 代码精通：使用 gemini_code 分析完整的代码库、生成解决方案和调试代码。
• 多文件处理：使用 gemini_fileops 处理60多种文件格式，包括PDF、图像等。
• 智能模型选择：自动为每个任务选择最佳的Gemini模型。
• 企业就绪：具备强大的错误处理、速率限制管理和API回退机制。

📦 安装指南

一键安装

npx @gemforge/mcp-server@latest init

手动设置

1. 创建配置文件 (claude_desktop_config.json)：

{
  "mcpServers": {
    "GemForge": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. 安装并运行：

npm install gemforge-mcp
npm start

💻 使用示例

基础用法

实时搜索示例

{
  "toolName": "gemini_search",
  "toolParams": {
    "query": "Latest advancements in quantum computing",
    "enable_thinking": true
  }
}

代码分析示例

{
  "toolName": "gemini_code",
  "toolParams": {
    "question": "Identify improvements and new features",
    "directory_path": "path/to/project",
    "repomix_options": "--include \"**/*.js\" --no-gitignore"
  }
}

多文件比较示例

{
  "toolName": "gemini_fileops",
  "toolParams": {
    "file_path": ["contract_v1.pdf", "contract_v2.pdf"],
    "operation": "analyze",
    "instruction": "Compare these contract versions and extract all significant changes."
  }
}

📚 详细文档

配置

环境变量

GEMINI_API_KEY=your_api_key_here       # 必需：Gemini API密钥
GEMINI_PAID_TIER=true                  # 可选：如果使用付费层（更好的速率限制），设置为true
DEFAULT_MODEL_ID=gemini-2.5-pro        # 可选：覆盖默认模型选择
LOG_LEVEL=info                         # 可选：设置日志详细程度（debug, info, warn, error）

Claude桌面集成

{
  "mcpServers": {
    "GemForge": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

高级模型选择

GemForge会为每个任务智能选择最佳模型：

• gemini_search：使用 gemini-2.5-flash 以实现速度和搜索集成。
• gemini_reason：使用 gemini-2.5-pro 以实现深度推理能力。
• gemini_code：使用 gemini-2.5-pro 以实现复杂代码理解。
• gemini_fileops：根据文件大小在 gemini-2.0-flash-lite 或 gemini-1.5-pro 之间进行选择。

可以在任何工具调用中使用 model_id 参数覆盖，或设置 DEFAULT_MODEL_ID 环境变量。

部署

Smithery.ai

通过 Smithery.ai 一键部署。

Docker

docker run -e GEMINI_API_KEY=your_api_key ghcr.io/pv-bhat/gemforge:latest

自托管

使用我们的 MCP.so目录列表 获取集成说明。

特色优势

• 跨生态系统能力：将Google的AI与Claude和其他MCP代理连接起来。
• 多文件分析：比较文档、图像或代码版本。
• 智能路由：根据任务要求自动选择模型。
• 生产就绪：专为企业环境构建。

社区与支持

• 加入我们：MCP Discord | GemForge Discord
• 贡献代码：GitHub讨论
• 反馈建议：在Discord上提出问题或分享想法。

文档

访问我们的 文档网站 以获取：

• 高级使用教程
• API参考
• 故障排除提示

🔧 技术细节

GemForge专为生产环境而构建：

• 支持60多种文件类型：处理从代码到文档再到图像的所有内容。
• 自动模型回退：即使在速率限制或服务中断期间也能继续运行。
• 企业级错误日志记录：提供详细的诊断信息以进行故障排除。
• API弹性：具备指数退避、重试逻辑和无缝模型切换功能。
• 完整代码库支持：使用可配置的包含/排除模式分析整个代码库。
• XML内容处理：对结构化数据进行专门处理。

📄 许可证

本项目采用MIT许可证。详情请参阅 LICENSE。

致谢

本项目由 Gemini API 提供支持，并受 模型上下文协议 启发。