图像生成服务

基于Gemini的MCP服务器,提供文本到图像的生成功能,支持多种宽高比和多种后端服务。

  • by aurynsinclair
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 aurynsinclair/organon-create-image

使用说明

有机物创造图像

使用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 有关设置的详细信息。

许可证

麻省理工学院