宝石锻造-mcp

Name: 宝石锻造-mcp
Author: PV-Bhat

作者：PV-Bhat4 星标更新：2025-05-16

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

项目介绍

GemForge (Gemini 工具)

概述

GemForge-Gemini-Tools-MCP: 为企业级 Gemini 集成提供支持，适用于您喜爱的 MCP 代理。增强 Claude、Roo Code 和 Windsurf 的代码库分析、实时搜索、文本/PDF/图像处理等功能。

快速导航

特性
快速开始
配置
工具
重型可靠性
部署
示例
社区
文档

为什么选择 GemForge？

GemForge 是 Google Gemini AI 与 MCP 生态系统之间的桥梁： gemfog

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

快速开始

单行安装

npx @gemforge/mcp-server@latest init

手动设置

创建配置文件（claude_desktop_config.json）：

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

安装并运行：

npm install gemforge-mcp
npm start

观看 30 秒设置演示 →

重型可靠性

GemForge 专为生产环境设计：

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

关键工具

工具	描述	主要能力
`gemini_search`	连接网络的信息检索	实时数据访问
`gemini_reason`	复杂问题解决，逐步逻辑	透明的推理过程
`gemini_code`	深度代码理解和生成	整个仓库分析
`gemini_fileops`	跨越 60 多种格式的多文件处理	文档比较和转换

{
  "toolName": "gemini_search",
  "toolParams": {
    "query": "量子计算的最新进展",
    "enable_thinking": true
  }
}

</details> <details> <summary>示例：代码分析</summary>

{
  "toolName": "gemini_code",
  "toolParams": {
    "question": "识别改进和新功能",
    "directory_path": "项目路径",
    "repomix_options": "--include \"**/*.js\" --no-gitignore"
  }
}

</details> <details> <summary>示例：多文件比较</summary>

{
  "toolName": "gemini_fileops",
  "toolParams": {
    "file_path": ["合同_v1.pdf", "合同_v2.pdf"],
    "operation": "analyze",
    "instruction": "比较这些合同版本，并提取所有重大变更。"
  }
}

</details>

配置

GemForge 提供灵活的配置选项：

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）

</details> <details> <summary>Claude Desktop 集成</summary>

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

</details> <details> <summary>高级模型选择</summary>

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 环境变量进行覆盖。

</details>

部署

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 代理。
多文件分析：比较文档、图像或代码版本。
智能路由：基于任务需求自动选择模型。
生产就绪：专为企业环境设计。

GemForge 在行动

社区和支持

加入我们：MCP Discord | GemForge Discord
贡献：GitHub 讨论
反馈：在 Discord 上打开一个议题或分享想法

文档

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

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

许可证

根据 MIT 许可证发布。详情见 LICENSE。

致谢

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