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 提供支持，並受 模型上下文協議 啟發。