# @chrischall/gemini-mcp 中文文档

规范地址：https://npmcn.com/package/%40chrischall/gemini-mcp/

版本：2\.5\.1
npm 元数据更新时间：2026-11-07T12:04:58.080Z
中文译文更新时间：2026-11-09T14:52:08.719Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chrischall/gemini-mcp
原文对照：https://npmcn.com/package/%40chrischall/gemini-mcp/?lang=original
项目主页：https://github.com/chrischall/gemini-mcp#readme
源码仓库：https://github.com/chrischall/gemini-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.8 MB，50 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：5 个
- 首次发布：2026-06-08T01:09:25.258Z
- 最新版本发布：2026-11-07T12:04:57.687Z
- 近 30 天下载量：4141（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

Claude的双子星图像生成 MCP 服务器——由AI(Claude Code)开发和维护

## 安装

```sh
npm install @chrischall/gemini-mcp
```

也可以使用：`pnpm add @chrischall/gemini-mcp`、`yarn add @chrischall/gemini-mcp`、`bun add @chrischall/gemini-mcp`

## README

# 遗传- mcp

[![CI](https://github.com/chrischall/gemini-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/chrischall/gemini-mcp/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/@chrischall/gemini-mcp)](https://www.npmjs.com/package/@chrischall/gemini-mcp) [![license](https://img.shields.io/npm/l/@chrischall/gemini-mcp)](https://npmcn.com/package/%40chrischall/gemini-mcp/LICENSE)

为谷歌双子座媒体生成的MCP服务器. 向克洛德展示13个工具 : 列出可用的模型,生成/编辑/编译图像,从主快多回合图像改进(Interactions API)生成一套一致的图像, **视频** 世代, **音乐** 生成(Lyria),一个针对长世代的同源结果民调,以及用于可再使用的图像引用的文件 API上传/列表/删除. 输出默认情况下会被写入磁盘( path return),或者作为碱基64返回入行. 建于双子座v1beta API上(`generativelanguage.googleapis.com`)使用"纳诺香蕉"(Nano Banana Pro (images)","OMNI"(video)"和"Lyria"(音乐)模范家庭.

由AI(Claude Code)开发和维护.

## 环境变量

| 变量 | 需求 | 说明 |
| --- | --- | --- |
| `GEMINI_API_KEY` | 对 | 您的 Google 双子座 API 密钥 ([aistudio.google.com/ apikey (英语)](https://aistudio.google.com/apikey)(中文(简体) ) |
| `GEMINI_IMAGE_MODEL` | 没有 | 覆盖默认图像模型( 默认 ): `gemini-nano-banana-2.1`(中文(简体) ) |
| `GEMINI_OUTPUT_DIR` | 没有 | 生成图像的默认目录( 默认 : ~/ Downloads/ gemini- mcp) 。 设定时,每个呼叫 `output_dir` 一定在里面 一定在车里. |
| `GEMINI_INPUT_DIR` | 没有 | 用于解析赤裸的输入图像文件名的目录( 所以) `images: ["foo.jpg"]` (单位:千美元) |
| `GEMINI_UPLOAD_DIR` | 没有 | 限制本地文件流到双子星文件 API ()`gemini_upload_file` `path`, (中文(简体) ), `video_path`)到这些目录——一个或多个,由 `:` (单位:千美元)`;` 窗口上; `~` 允许。 任何上传前, 外部路径都会被拒绝 。 取消设置: 无限制 |
| `GEMINI_REFERENCE_DIR` | 没有 | 限制当地 **参考图像** (单位:千美元) `images` 编号 : `master_images` 路径读取并发送到双子座——内置,或作为文件API再用后上传到这些目录—— `:`\- 分离(`;` 在视窗上, `~` 允许; `GEMINI_OUTPUT_DIR` 总是允许的,所以生成的图像可以反馈到里面. 外出路径(所遵循的符号链接)在读取前被拒绝. 取消设置 : `GEMINI_UPLOAD_DIR` 改为适用。 如果两者均为未设置,则参考图像为 **非限制性** 在本地安装上(服务器可以读取的任何文件都可以发送),并限制在 `$MCP_DATA_DIR/uploads` 何时 `MCP_DATA_DIR` 设置( 托管) |
| `GEMINI_TIMEOUT_MS` | 没有 | 上游请求超时 ms( 默认 ): `60000`,或 `120000` 页:1 `image_size: "4K"`);每一代工具也采用每集调用 `timeout_ms` |
| `GEMINI_HEARTBEAT_MS` | 没有 | 当一代运行时( 默认值 : `10000`· ; `0` disables)——让重新设定进度超时的MCP主机从计时出出长世代 |
| `GEMINI_CHAIN_RETRY_MS` | 没有 | 当连锁呼叫404s时(默认: `120000`· ; `0` 禁用重试) |

### 确认

发送 **本地文件** 转到 Google ( `images` 编号 : `master_images` 编号 : `video_path` 输入,或 `gemini_upload_file`是因为 `path`和每个 **删除** 先请求确认 客户端可以 显示确认提示( Claude Code) 获得真实提示, 除非 `MCP_CONFIRM_ELICITATION=off`。 。 。 . 在别的地方,第一个电话是 无并返回预览(已解析的本地路径及其MIME类型和大小,或 方法/路径被删除)加a `confirmToken`;只有重复的呼唤,同样的论点和 那个象征性的收益。 符号是单用、过期的,并且与确切的论点——a 已更改的提示或两个调用之间的互换文件被拒绝 。 纯文本提示, URL, `files/` 参考文献和基数64没有门.

| 变量 | 默认 |  |
| --- | --- | --- |
| `MCP_CONFIRM_MODE` | `ask-user` | 无法显示确认提示的客户端的写作( Claude.ai, Claude Desktop) . `ask-user`:分出两个步骤——第一个呼叫无所事事,返回一个预览加一个符号,模型在再次与它通话之前,必须获得您在聊天中的认可. `auto`:相同的两个步骤,但模型在审查预览本身后可能会使用符号. `refuse`:拒绝为此类客户写作。 能显示提示的客户端( Claude Code) 总是得到真正的提示, 除非 `MCP_CONFIRM_ELICITATION=off`。未识别值作为 `refuse`。 。 。 . |
| `MCP_CONFIRM_ELICITATION` | `on` | `off` 从不显示确认提示, 所以每个客户端都会收到 `MCP_CONFIRM_MODE` 路径。 设定为声称支持快讯但从未显示一个的客户端(有门的呼叫被挂起-开码2.0.x). 任何其它数值保留 `on`上面写着警告. |
| `MCP_CONFIRM_TTL_SECONDS` | `600` | 一个符号保持有效多久. |
| `MCP_CONFIRM_SECRET` | 每个进程随机 | 签名密钥; 仅在令牌必须在服务器重新启动后幸存时设置它 . |

### 长辈和客户超时

4K / 亲模代能跑过 MCP 主机本身 `tools/call` 超时( 错误) `-32001`) (中文(简体) ). 服务器发送 `notifications/progress` 心跳使主机重新设定超时 进步等待它出来。 如果主机仍然放弃, 服务器侧生成通常会完成 无论如何: 图像写入输出目录, `gemini_interact` 也写着 `<image>.json` 侧车记录 `interaction_id`,以及 `continue_last: true` 恢复 共享丢失的响应属于.

### 当连锁电话404

404应请求携带 `previous_interaction_id` 实值 **没有** 证明链已过期 。 这个 仅观测到404具活体是通用的—— `"Requested entity was not found."` - 从来没有名字 _哪个_ 实体。 未知或更名 **型号编号**,以及过期的文件 API **`files/…` 乌里** (~48h TTL),返回完全相同的东西. 这样服务器就不再声称不能 确定:上游文本是逐字浮出 `gemini_interact` 运行一个实验到 找出是哪个.

通常,身份证明完全没有丢失——它只是不是 _可见_ 还没有。 互动商店是 最终一致,一个刚创建的id可以404 而同样的id解决 细分钟 后;重转(4K,正, `thinking_level: high`最能击出它 这正是你最想要的 链从。 所以一个被锁链的404 重试的指数 备份最多 **120岁** (单位:千美元)`GEMINI_CHAIN_RETRY_MS`在宣布任何破损之前。 这个 404没有产生什么,也没有计费,所以等待成本只有时间.

预算用完后,工具检查了ID的侧车, 重新接上它的形象 并重新发出请求 **无** 链条 :

-   **重发成功** - 锁链真的是问题, 反正你得到你的形象, 报告为 `chain_recovered: { expired_interaction_id, reanchored_on }`404的尝试 所以这要花一代人的钱 来做手动的重新定位.
-   **再发行404** 互动 ID 从来不是原因。 你被告知, 和上游文字,并指代模型 id 和任何 `files/…` 里 而不是现在 被派去追寻一个一直很好的互动.
-   **没有侧行车匹配死亡的ID** - 最初的错误,而不是猜测。 重新纠缠 错误的图片会悄悄地腐蚀编辑.

分开, `continue_last` 不再随服务器进程而死:没有内存编号 从最新 `<image>.json` 输出目录和报告中的侧车 `continued_from_sidecar: true`案件从来就不是一个过期的链条——相互作用 在上游一直活着 只有我们对它的记忆消失了.

对于不能被驯服而超时的主机(例如克洛德桌面,一个被忽略的固定的~30s盖) 两名警卫负责安全、不必要地重新发放:

-   **`async: true`** 返回 a `job_id` 而不是影像,所以电话不能 完全超时;民意调查 `gemini_get_result` 与 `job_id` 直到它变成 `done`。 。 。 .
-   **`idempotency_key`** 使重复调用“同键”重试返回 记录结果(`reused: true`)取而代之,取而代之. (即使没有钥匙, 两个相同的飞行中电话自动调用。 )

## 工具

| 工具 | 说明 |
| --- | --- |
| `gemini_list_models` | 列出可用的双子座图像模型和当前默认值 |
| `gemini_image_generate` | 从文本提示生成图像 |
| `gemini_image_edit` | 一次性编辑或带有文本指令的多图像组成(用于一系列编辑、使用) `gemini_interact`(中文(简体) ) |
| `gemini_image_set` | 生成主图像外加 N 一致图像参考 |
| `gemini_interact` | 用于迭代改进的首选工具:多回合生成/编辑,通过互动 API——将返回的链条 `interaction_id` 通过 `previous_interaction_id` (或 `continue_last: true`(中文(简体) ) |
| `gemini_video_generate` | 制作一段短视频(文本-视频、图像-视频、两段插图, `edit` 或者说 `extend`通过双子座模型; `resolution` 360p/720p/1080p/4k 是成本杠杆; 写入磁盘为 MP4 |
| `gemini_music_generate` | 通过Lyria模型从文字提示中生成音乐—— `lyria-3-clip-preview` (30s,违约), `lyria-3.5` (全长,相声)或 `lyria-3-pro-preview`; 单转; 写入磁盘为 MP3 |
| `gemini_get_result` | 获取启动的同步生成 `async: true` 联合国 `job_id` (状况) `running` → `done` 结果)。 让一代人活过宿主 `tools/call` 超时 |
| `gemini_token_usage` | 本届会议迄今为止的使用情况和估计的美元费用。 在一个工作流程之前和之后调用并减去,以归属该工作流程的支出. 以每通电话的价格与每通电话自己的型号相比,从一张日期已晚的收费卡中定价(`GEMINI_RATE_CARD` 覆盖它; 没有账户余额端点可以读取, 所以支出就是这样被归属的 |
| `gemini_upload_file` | 将图像(或视频/音频)上传到双子座文件 API 一次——从 a `url`, (中文(简体) ), `data_base64`,或当地 `path` - 并获得可重复使用 `files/<id>` 参考文献 |
| `gemini_list_files` | 列出当前在此 API 密钥下上传的文件, 包含 MIME 类型和过期时间 |
| `gemini_delete_file` | 删除上传的文件在 ~48h 到期前( 先确认 —— 见 [确认](https://npmcn.com/package/%40chrischall/gemini-mcp/#readme-confirmations)(中文(简体) ) |
| `gemini_sign_media` | _(仅安排部署)_ Mint 用于从它生成的媒体的新签名的 URL `r2_key` - 过期的链接不是死路 |
| `gemini_view_media` | _(仅安排部署)_ 返回生成的图像作为内置图像块 `r2_key`,所以一个模型 可以看到它做之前 |
| `gemini_get_upload_url` | _(仅安排部署)_ Mint 短寿命签名的 PUT URL , 所以 shell 可以上传一个没有认证头的参考图像; PUT 返回一个 `r2_key` 可用于 `images_r2_keys`, (中文(简体) ), `gemini_save_character`,或 `gemini_upload_file` |
| `gemini_save_character` 编号 : `gemini_list_characters` 编号 : `gemini_delete_character` | _(仅安排部署)_ 持续每个账户字符库:在名称下保存参考图像+描述,然后通过 `characters: ["name"]` 关于生成工具。 无过期 |
| `gemini_save_style` 编号 : `gemini_list_styles` 编号 : `gemini_delete_style` | _(仅安排部署)_ 持续的每个账户样式预设:可重复使用的快取片段(可选择带有参考图像),通过使用 `style: "name"` 关于生成工具。 无过期 |

生成工具还共享三个吞吐量/纬度控制: `async: true` ( 返回 a `job_id` 立即, `max_wait_ms` (等待预算,然后把 `job_id` ——成绩保持快 带内,慢批次从不绊倒主机超时),并 `idempotency_key` (重试返回 记录结果,而不是重新计票)。 在托管的部署中,a `gemini_image_set` 结果 多个图像还带有 **`bundle_url`** ——一个签名的 URL,用于对每个图像进行拉链 设定。 与每个主机链接一样,它最多活到24小时(主机的blob-store天花板); `gemini_sign_media` 重点一个过期的。 (设定太高,不能 在记忆中安全地拉链 跳过捆绑 并说通过 `bundle_skipped`; 每幅图像 链接不受影响。 )

## 看到你的图像(托管)

在主机部署上没有文件系统,所以生成的图像必须作为 东西你可以 _打开_它确实: **每个结果都包含一个 URL**,没有配置.

```jsonc
{
  "images": ["https://mcp.nullnet.app/b/<account>/gemini/gen/2026-07-29/ab12cd34-a-cat.png?exp=…&sig=…"],
  "media":  [{ "url": "https://…", "r2_key": "gen/2026-07-29/ab12cd34-a-cat.png",
               "expires_at": "2026-07-31T12:00:00.000Z",
               "curl_hint": "curl -sS -o a-cat.png \"https://…\"" }]
}
```

这些链接不需要认证头, 签名在 URL 中, 因此它们在浏览器中工作 `curl`,在聊天留言中。 最多24小时后就过期了 东道主的blob商店拒绝 更长的签名——以及后面的物体被覆盖在主机的保存时间表上. 这个 `r2_key` 是窗口的持久控件 :

-   **`gemini_sign_media`** (只托管部署) 薄荷从一个 `r2_key`, (中文(简体) ), 因此,一个过期的链接永远不会迫使你重新生成——并重新支付——图像.
-   **交互 ID 存储在每个图像旁边**,所以一个主机部署 恢复一个丢失 改变当地人的方式: `continue_last: true` 在重启后幸存下来,链式404是 重新关注互动产生的形象 `gemini_list_recent_media` 显示 每个存储对象的即时,模型和交互id,而不是一串密钥的墙.
-   **`gemini_view_media`** (仅主机部署)从内线返回图像本身 `r2_key`连结不是模型可以看的东西,所以没有这个生成 ~ 精细 循环运行失明。 这是一个单独的呼叫,而不是每个结果的字节:你支付图像 只在你实际看的转弯处有指示牌.
-   **`gemini_upload_file` 与 `r2_key`** 将此服务器生成的媒体转换成文件 API 参考(服务器用自己的密钥读回来——没有签名让你做薄荷),所以 一个生成的图像可以在一个便宜的呼叫中成为下一代的参考图像.
-   重复播放(`idempotency_key`)在记录结果中重命名 URL 所以再利用的结果 永远不会有死链.

**为什么这很重要:** MCP的内置图像内容块(`inline: true`)可见 _助理人员_ 但很多聊天客户端从未将它们提供给用户,而助理不能 从自己的上下文中取出字节以保存到其他地方. 一代人会付帐 成功和隐形。 URL是可移植的答案; `inline` 仍然可用,但 这不再是接受媒体的唯一办法.

### 字节是如何送达的

主机存储每个生成的对象, 并按签名服务到到期 URL —— (中文) `https://<host>/b/<account>/gemini/<key>?exp=&sig=`。没有设置,也没有认证 标题:链接中的签名是授权,所以 `curl` 和浏览器 两者都行.

**Auth 是已签名的, 过期的 URL 而不是未列出的密钥 .** 随机键将 简而言之,但不会过期,也不会撤销 链接将永远运作。 签字范围包括进入一个有最后期限的物体,以及 旋转主机签名密钥( r)`MCP_BLOB_SIGNING_KEY`时,mcp-host会与 `MCP_BLOB_BASE_URL`; 此服务器从不选择) 使每个未完成的链接无效 一次 一次吗 权衡的是,联系很长,不能靠手缩短.

### 助理转发结果

显示用户的 URL 。 如果您的沙盒有网络向主机进发, 获取它 并附加字节作为文件给出最优的结果;否则会呈现链接本身. 给定客户端是否使 `![](url)` 标记下内线因客户端而异——一个空的 URL 是 安全的形式, 和标记下的联系 是合理增强 在你知道它会.

### 保留

保留是主机的,不是这个服务器的设置. 在mcp -host, 斑点商店花花 生成的介质 (`gen/`)和签名上传(`up/`)按自己的时间安排(参见mcp-host) `docs/BLOB-STORE.md`; 默认30天),而字符/样式库(`lib/`)写作 保留豁免,所以保存的条目永远不会过期. 每个签名的链接都被夹在店里 24小时的天花板,所以它不会超过 商店的荣誉; `gemini_sign_media` 重点一 只要对象存在。 此服务器读取的变量由 主机 : `MCP_BLOB_BASE_URL` 财务报告和审定财务报表 `MCP_BLOB_SIGNING_KEY`。 。 。 .

**提示也存了起来.** 在主机部署中生成的每个对象都得到一个小 JSON 在它旁边有提示(前500个字符),模型和交互id——即 什麽 `gemini_list_recent_media` 显示什么让失去的转弯被恢复。 记录的生命 并被用它的对象所覆盖, 所以它保存在同一保留窗口, 而不是更长. 当地, `gemini_interact` 写入 `<image>.json` 侧式车(型号、互动代号、选项和 模型在输出目录中每个图像旁边用任何文本——而不是提示本身——回答; 这些文件是属于你的 保存或删除, 永远不会过期 自己。 狦 提示中描述的是真实的人 记住他们坐在你的水桶里.

## 不燃烧上下文而发送参考图像

每一个有参考图像的工具—— `gemini_image_generate`, (中文(简体) ), `gemini_image_edit`, (中文(简体) ), `gemini_image_set`, (中文(简体) ), `gemini_interact`附加时 `gemini_video_generate` (参考保留)和 `gemini_music_generate` - 接受它们四种方式。 其中只有一个成本模型背景:

| 参数 | 字节旅行的地方 | 背景成本 |
| --- | --- | --- |
| `images_url` (单位:千美元)`master_images_url`(中文(简体) ) | 页:1 **服务器** 下载 https URL | 无 |
| `images_file_uris` (单位:千美元)`master_images_file_uris`(中文(简体) ) | (单位:千美元) `files/<id>` 引用, 已经上传 | 无 |
| `images_r2_keys` (单位:千美元)`master_images_r2_keys`(中文(简体) ) | 服务器读取其 **自有仓库** (仅安排部署) | 无 |
| `images` | 从本地磁盘上读取( 仅建 stdio ) | 无 |
| `characters` 编号 : `style` | 保存的图书馆条目,按名称附加(仅托管部署) | 无 |
| `images_base64` | **通过工具调用 JSON** | **每个 JPEG ~ 14k 令牌** |

`images_base64` 是最后手段的倒计时。 每张小照片大约要花费14克, 它默默地腐烂了,只要文件读出它,它就被截断了 有效载荷看起来仍然像基座64,所以故障表面是一个坏一代而不是一个 错误。 偏取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所取所相相相相相相相相相.

### `images_url` ——服务器获取

```jsonc
{ "prompt": "make it look like winter", "images_url": ["https://example.com/photo.jpg"] }
```

获取仅限于公开 `https://` URL — 私有、回回和链接本地主机 拒绝( IPv6 字节被解析, 所以) `[::ffff:7f00:1]` 以回转方式抓取,每个方向 hop被重新验证,每个hop都会被限定为超时. 对策必须是 `Content-Type: image/*` 并封顶于 **15MB (英语)**,在流出而非信任时执行 从 `Content-Length`。失败会命名违法的 URL 。 超过6MB的任何东西都会上传到 文件 API 和由 uri 引用,而不是内含,因为 `generateContent` 覆盖整个 请求接近 20MB.

### `images_file_uris` ——上传一次,引用多次

```jsonc
// 1. upload
{ "tool": "gemini_upload_file", "url": "https://example.com/photo.jpg" }
// → { "file_uri": "files/abc123", "mime_type": "image/jpeg", "expires": "..." }

// 2. reference it, as many times as you like
{ "prompt": "make it winter",  "images_file_uris": ["files/abc123"] }
{ "prompt": "make it sunrise", "images_file_uris": ["files/abc123"] }
```

上传保留 **~48小时**;在此之后,参考停止解决(作为通用404——) 见上文链条-404节). `gemini_image_set` 获取或解决这样的引用 **一次** 并传递给主人 和每一个场景呼叫.

在Stdio大楼,一个当地 `images` 被引用的路径 **一次以上的会议** 实值 自动上传到文件 API( 键于路径 + mtime + 大小), 因此重复编辑 同一相片停止重接字节。 编辑文件将缓存上传无效 .

### 已签名的上传 URL —— 完全没有符号( 托管)

这是有外壳的代理商的预定路径: 磁盘文件 ~ 卷曲 ~ `r2_key` - 工具呼叫, 图像从不进入对话. `gemini_get_upload_url` 薄荷薄荷短命 (~10分钟)签名 **点** URL,且 shell 上传了 0 认证头 — 签名在 uRL 是授权, 映射下载链接的工作方式 .

```bash
# 1. tool call: gemini_get_upload_url { filename: "photo.jpg", content_type: "image/jpeg" }
#    → { upload_url, r2_key, expires_at, curl_hint }

# 2. shell:
curl -sS -X PUT -H "Content-Type: image/jpeg" --data-binary @photo.jpg "$UPLOAD_URL"
# → { "r2_key": "up/<tenant>/2026-07-31/ab12cd34-photo.jpg", "size_bytes": 812345, ... }
```

签字包括一个租户范围的物品钥匙、申报的内容类型和过期; 上传被封顶为15MB,在读取溪流时执行. 仅 **光栅** 图像类型是 (jpeg/png/webp/gif/avif/heic/heif/bmp/tiff)—— SVG被故意拒绝,因为 SVG 是可脚本文档,并且 `/media` 服务来自服务器自己的来源。 回来的 `r2_key` 然后可以使用三种方式: `images_r2_keys` 在任意生成工具上 服务器读取自己的桶——对话中没有字节),永久通过 `gemini_save_character`,或者作为 ~48h 文件 API 的参考 `gemini_upload_file({ r2_key })`。 。 。 . 上传自己遵循主机的 blob- store 保留时间表(`up/` 前缀).

### 字符样式库( 托管) (S)

经常性主体和样式可以保存一次,每个账户,用 **无过期** (图书馆的) `lib/` 对象被写入保留豁免,所以主机的prune跳过它们:

```jsonc
// once:
{ "tool": "gemini_save_character", "name": "finn",
  "description": "6-year-old boy, curly red hair", "image_r2_key": "up/…/photo.jpg" }
{ "tool": "gemini_save_style", "name": "bold-cartoon-sports",
  "prompt_fragment": "bold cartoon style, thick outlines, saturated colors" }

// afterwards, on any generation:
{ "tool": "gemini_image_set",
  "master_prompt": "Finn on a soccer field",
  "scenes": ["kicking the ball", "celebrating a goal"],
  "characters": ["finn"], "style": "bold-cartoon-sports" }
```

命名字符附加其保存的参考图像并将其描述编织到 提示; 命名样式附件其片段( 如果有参考图像, 则附上参考图像) . `gemini_image_set` 将字符引用传递给主机 _和每个场景呼叫_,这是 是什么使题材在全场一致.

## 快速启动

```json
{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@chrischall/gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

见 [SKILLL.MD (英语)](https://npmcn.com/package/%40chrischall/gemini-mcp/skills/gemini-mcp/SKILL.md) 供充分使用的文件.

## 常见问题

### @chrischall/gemini-mcp 是什么？

Claude的双子星图像生成 MCP 服务器——由AI\(Claude Code\)开发和维护

### 如何安装 @chrischall/gemini-mcp？

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

### @chrischall/gemini-mcp 支持 TypeScript 吗？

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

### @chrischall/gemini-mcp 支持 ESM 还是 CommonJS？

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

### @chrischall/gemini-mcp 可以商用吗？

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

### @chrischall/gemini-mcp 的下载量有多少？

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

### @chrischall/gemini-mcp 还在维护吗？

最新版本 2\.5\.1 发布于 2026/11/07（2 天前）；至今共发布 54 个版本，其中过去 12 个月发布了 54 个；首次发布于 2026/06/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。