GemForge (Gemini Tools)

GemForge（Gemini 工具）

概述

GemForge-Gemini-Tools-MCP：面向您喜爱的 MCP Agent 的企业级 Gemini 集成。借助代码库分析、实时搜索、文本/PDF/图像处理等功能，为 Claude、Roo Code 和 Windsurf 提效。

快速导航

• 功能
• 快速开始
• 配置
• 工具
• 高可靠性
• 部署
• 示例
• 社区
• 文档

为什么选择 GemForge？

GemForge 是连接 Google Gemini AI 与 MCP 生态系统的关键桥梁：

• 实时网络访问：使用 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

观看 30 秒设置演示 →

高可靠性

GemForge 专为生产环境打造：

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

主要工具

{
  "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."
  }
}

GemForge 提供灵活的配置选项：

GEMINI_API_KEY=your_api_key_here       # Required: Gemini API key
GEMINI_PAID_TIER=true                  # Optional: Set to true if using paid tier (better rate limits)
DEFAULT_MODEL_ID=gemini-2.5-pro        # Optional: Override default model selection
LOG_LEVEL=info                         # Optional: Set logging verbosity (debug, info, warn, error)

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

部署

Smithery.ai

通过 Smithery.ai 一键部署

Docker

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

自托管

请参阅我们的 MCP.so 目录条目，了解集成说明。

GemForge 有何独特之处？

• 跨生态系统协作：将 Google 的 AI 与 Claude 及其他 MCP Agent 连接起来
• 多文件分析：比较文档、图像或不同版本的代码
• 智能路由：根据任务需求自动选择模型
• 为生产环境打造：适用于企业环境

社区与支持

• 加入我们：MCP Discord | GemForge Discord
• 参与贡献：GitHub 讨论区
• 反馈：提交 issue，或在 Discord 上分享想法

文档

请访问我们的文档网站，了解：

• 高级用法教程
• API 参考
• 故障排除技巧

许可证

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

致谢

• 感谢 Google Gemini API 提供底层 AI 能力
• 感谢 Model Context Protocol (MCP) 对 AI 工具接口进行标准化