有机物创造图像
使用Gemini生成图像的MCP服务器。
特性
- 文本到图像生成 通过Gemini(默认:
gemini-3-pro-image-preview) - 支持多种宽高比(1:1、16:9、9:16等)
- 通过MCP图像内容类型以文件和内联方式返回生成的图像
- 支持两者 AI 工作室 (API密钥)和 顶点AI (服务帐户)后端
先决条件
- Node.js 18+
- 以下之一:
- AI 工作室:Gemini API密钥来自 谷歌AI工作室 - 顶点AI:启用Vertex AI API+应用程序默认凭据的谷歌云项目
设置
npm install
npm run build配置
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
GEMINI_API_KEY | 选项1 | - | AI Studio API键(优先于Vertex AI) |
VERTEX_PROJECT | 选项2 | -- | 谷歌云项目ID(顶点AI) |
VERTEX_LOCATION | 没有 | us-central1 | 顶点AI位置 |
注: 设置其中之一GEMINI_API_KEY或VERTEX_PROJECT如果两者都被设置,GEMINI_API_KEY优先考虑。
克劳德代码MCP注册
AI 工作室 (建议用于访问预览模型):
{
"mcpServers": {
"create-image": {
"command": "node",
"args": ["/path/to/organon-create-image/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}顶点AI:
{
"mcpServers": {
"create-image": {
"command": "node",
"args": ["/path/to/organon-create-image/dist/index.js"],
"env": {
"VERTEX_PROJECT": "your-gcp-project-id"
}
}
}
}工具
generate_image
从文本提示生成图像。
参数:
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
prompt | string | Yes | -- | 图像生成的文本提示(推荐英文) |
aspect_ratio | enum | 否 | "1:1" | 纵横比: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
output_path | string | 是 | -- | 保存生成图像的文件路径(.png) |
model | string | 否 | "gemini-3-pro-image-preview" | Gemini型号名称(例如。 gemini-2.5-flash-image) |
退货: 生成的图像已保存到 output_path,加上通过MCP图像内容类型的内联图像。
质量检查
一次运行所有质量检查:
npm run check:all这将按顺序执行以下检查:
| 脚本 | 检查 | 工具 |
|---|---|---|
typecheck | 类型检查(严格) | tsc--noEmit |
lint | Linter+圈复杂度 | ESLint+排版ESLint |
format:check | 代码格式化 | 预处理 |
test:coverage | 测试+覆盖率报告 | Vitest+V8 |
audit | 已知CVE扫描 | npm审计 |
audit:lockfile | 锁文件完整性 | 锁文件lint |
sast | 安全静态分析 | Semgrep |
注: Semgrep需要通过以下方式单独安装 pip。参见 质量.md 有关设置的详细信息。许可证
麻省理工学院
