Gemini集成工具

GemForge是一款企业级Gemini集成工具,为MCP代理提供实时搜索、代码分析、多文件处理等功能,适用于复杂逻辑处理和代码库分析。

  • by PV-Bhat
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 pv-bhat/gemforge-mcp

使用说明

GemForge(双子座工具)

概述

GemForge Gemini工具MCP:企业级Gemini集成,适用于您最喜欢的MCP代理商。为Claude、Roo Code和Windsurf提供代码库分析、实时搜索、文本/PDF/图像处理等功能。

快速导航

为什么选择GemForge?

GemForge是谷歌Gemini AI和MCP生态系统之间的重要桥梁:

  • 实时Web访问:获取突发新闻、市场趋势和当前数据 gemini_search

  • 高级推理:通过逐步思考来处理复杂的逻辑问题 gemini_reason

  • 代码掌握:使用分析完整存储库、生成解决方案和调试代码 gemini_code

  • 多文件处理:可处理60多种文件格式,包括PDF、图像等 gemini_fileops

  • 智能选型:为每个任务自动路由到最佳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"
      }
    }
  }
}
  1. 安装并运行:
npm install gemforge-mcp
npm start

观看30秒设置演示→

重型可靠性

GemForge是为生产环境构建的:

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

关键工具

工具 描述 关键能力
gemini_search Web连接信息检索 实时数据访问
gemini_reason 用循序渐进的逻辑解决复杂问题 透明的推理过程
gemini_code 深入的代码理解和生成 完整的存储库分析
gemini_fileops 跨60多种格式的多文件处理 文档比较和转换
Example: Real-Time Search
{
  "toolName": "gemini_search",
  "toolParams": {
    "query": "Latest advancements in quantum computing",
    "enable_thinking": true
  }
}
Example: Code Analysis
{
  "toolName": "gemini_code",
  "toolParams": {
    "question": "Identify improvements and new features",
    "directory_path": "path/to/project",
    "repomix_options": "--include \"**/*.js\" --no-gitignore"
  }
}
Example: Multi-File Comparison
{
  "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提供灵活的配置选项:

Environment Variables
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)
Claude Desktop Integration
{
  "mcpServers": {
    "GemForge": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}
Advanced Model Selection

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 run -e GEMINI_API_KEY=your_api_key ghcr.io/pv-bhat/gemforge:latest

自托管

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

是什么让GemForge与众不同?

  • 跨生态系统力量:将谷歌的人工智能与克劳德和其他MCP代理联系起来
  • 多文件分析:比较文档、图像或代码版本
  • 智能路由:根据任务要求自动选择模型
  • 生产准备就绪:专为企业环境构建

社区与支持

文档

访问我们的 文档网站 用于:

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

许可证

根据MIT许可证获得许可。看 许可证 了解详情。

致谢

  • Google Gemini API提供底层人工智能功能
  • 用于标准化AI工具接口的模型上下文协议(MCP)