@fre4x/gemini

中文文档
1.1.29发布于 2026/10/23MITES Module近 30 天下载 2683

提供多模式分析和图像/视频生成的双子座 MCP 服务器.

中文使用文档
文档目录8 节
  1. 工具
  2. 所需资源
  3. 环境变量
  4. 模拟模式
  5. 部署
  6. 页:1
  7. 发展
  8. 许可证

gemini——情报桥

能够看见、听到和想象的特工是无法超越的特工.

部分 FRE4X-B1TE (法语) ——为自主代理所建造的MCP服务器的单列.

Google的双子座不是聊天人 这是一个多式联运推理引擎。 这个B1TE将你的代理直接连接到那个引擎上——文本,图像,视频,音频——这样它就可以将世界看做是人类做的,然后超越它.

工具

工具能力
analyze_media通过 URL 分析图像或音频文件 file:// 路径。 提示是可选的.
list_models列表支持的模式 analyze_media, (中文(简体) ), generate_image,以及 generate_video过滤器 analyze, (中文(简体) ), image, (中文(简体) ), video,或 all。 。 。 .
generate_image通过纳米香蕉图像合成 generateContent 与 imageConfig.aspectRatio可选保存到 output_dir。 。 。 .
generate_video通过 REST 互动 API 启动 ASync 双子座 Omni 视频生成(gemini-omni-1.1-flash (默认情况下). 返回交互身份以进行民调 .
get_video_status单接 状态检查( 返回) done: false 时 queued编号 :in_progress) (中文(简体) ). 设定 wait=true 以屏蔽到完整或超时。 准备时通过文件 API 下载 。 可选保存到 output_dir。 。 。 .

所需资源

A 类 谷歌 AI Studio API 密钥 - 设为 GEMINI_API_KEY。 。 。 .

环境变量

变量目的
GEMINI_API_KEYAPI 实时通话( 除非 MOCK=true) (中文(简体) ).
GEMINI_IMAGE_MODEL覆盖默认图像模型( E)gemini-3.1-flash-image) (中文(简体) ).
GEMINI_VIDEO_MODEL覆盖默认 Omni 视频模型 (gemini-omni-1.1-flash) (中文(简体) ).
GEMINI_VIDEO_POLL_TIMEOUT_MSMax 等会儿 get_video_status.wait=true (默认为60万ms.
GEMINI_MEDIA_FETCH_TIMEOUT_MS交互/ Files HTTP 调用( 默认 30000 ms) 的每个请求超时 .

在建视频的投票间隔是 GEMINI_VIDEO_POLL_INTERVAL_MS (5秒) 使用时 wait=true 或文件 API 处理.

模拟模式

没有 API 密钥( 返回形状相同的固定数据) 运行 :

MOCK=true npx @fre4x/gemini

部署

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@fre4x/gemini"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

页:1

  • 图像生成 用纳米香蕉 generateContent 与 responseModalities: ["IMAGE"] 财务报告和审定财务报表 imageConfig.aspectRatio (不是图像). 检查 AI 工作室 为模型访问.
  • 视频生成 使用该 互动 API 与 x-goog-api-key 页眉认证( 绝不 ?key= 在 URL 上). 流量 : generate_video 打电话 get_video_status 每个~5号 直至 done: true,或通过 wait=true 进行状态检查直到完成.
  • 工具错误包括 recovery_class数字 : agent_recoverable (用已更正的段落/模型重审) vs user_action_required (修改、认证、配额、, requires_action) (中文(简体) ).
  • analyze_media 接受 file:// 从 URL 扩展名(jpg, png, mp4, mp3, wav, pdf等)中自动检测本地文件和 MIME 类型的路径 。 如果你遗漏 prompt,它默认为“描述此媒体”并使用 gemini-3.8-flash 默认.
  • analyze_media 拒绝已退休的文本模型化名,例如: gemini-1.5-* 财务报告和审定财务报表 gemini-2.0-*操作 model,使用当前支持的 generateContent 型号.
  • output_dir 打开 generate_image 财务报告和审定财务报表 get_video_status 将文件保存到磁盘中。 若不存在则创建目录.
  • 模式默认故意被固定在最新核实的当前日期的双子座官方文件上. 不要用陈旧的模型知识取而代之.

发展

npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests
npm run inspector # MCP inspector in mock mode

许可证

麻省理工学院 - 我们是FRE4X.

版本与发布记录

@fre4x/gemini 共发布 61 个版本,首次发布于 2026/02/28;过去 12 个月发布了 61 个版本。

版本发布日期距今
1.1.29latest2026/10/2323 天前
1.1.282026/10/2125 天前
1.1.272026/10/2125 天前
1.1.262026/09/221 个月前
1.1.132026/09/112 个月前
1.1.112026/09/062 个月前

其他发布通道:beta → 1.1.0-beta.6。

关于 @fre4x/gemini 的常见问题

@fre4x/gemini 是什么?

提供多模式分析和图像/视频生成的双子座 MCP 服务器.

如何安装 @fre4x/gemini?

在项目目录运行 npm install @fre4x/gemini,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gemini,可以用 npx gemini 直接运行。

@fre4x/gemini 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fre4x__gemini 是否存在。

@fre4x/gemini 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fre4x/gemini 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fre4x/gemini 可以商用吗?

@fre4x/gemini 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fre4x/gemini 的下载量有多少?

根据 npm 官方下载统计,@fre4x/gemini 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,683 次,日均约 89 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fre4x/gemini 还在维护吗?

最新版本 1.1.29 发布于 2026/10/23(23 天前);至今共发布 61 个版本,其中过去 12 个月发布了 61 个;首次发布于 2026/02/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。