Day 1 Image Generation MCP

图像生成mcp

一个MCP（模型上下文协议）服务器，用于使用人工智能生成博客和社交媒体图像。目前支持谷歌的Gemini/Nano Banana图像生成模型，其提供商架构旨在易于扩展。

安装： npx -y image-generation-mcp

特性

• 平台预设：Ghost、Medium、Instagram、Twitter、LinkedIn、YouTube等的预配置维度
• 多个质量级别：标准（快速）或高（使用Gemini Pro获得更好的质量）
• 自动保存：图像始终保存到磁盘（永远不会丢失，因为只有base64响应）
• PNG元数据：每个图像中都嵌入了提示、型号、样式和生成信息
• 提供商架构：可扩展设计，支持多个AI提供商
• 安全第一：输入验证、及时清理、安全错误处理

快速开始

环境变量

从获取API密钥 谷歌AI工作室.

______________________________________________________________________

Claude代码设置

选项1：已发布包（推荐）

# Add to Claude Code (user scope - available in all projects)
claude mcp add image-gen --scope user -e GOOGLE_API_KEY=your-api-key -- npx -y image-generation-mcp

# Or add to current project only
claude mcp add image-gen -e GOOGLE_API_KEY=your-api-key -- npx -y image-generation-mcp

方案2：地方发展

# From the project directory, build first
npm run build

# Add local server to Claude Code
claude mcp add image-gen -e GOOGLE_API_KEY=your-api-key -- node /absolute/path/to/image-generation-mcp/dist/index.js

选项3：手动配置

添加 ~/.claude.json （用户范围）或 .mcp.json （项目范围）：

{
  "mcpServers": {
    "image-gen": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "image-generation-mcp"],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

对于当地发展：

{
  "mcpServers": {
    "image-gen": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/image-generation-mcp/dist/index.js"],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

验证安装

# List configured MCP servers
claude mcp list

# Check status within Claude Code
/mcp

______________________________________________________________________

Claude桌面设置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["-y", "image-generation-mcp"],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

______________________________________________________________________

工具

generate_blog_image

为博客文章或社交媒体生成图像。

参数：

例子：

Generate a blog banner for my post about TypeScript best practices.
Use format: medium-ghost-spooky, style: modern minimalist

list_image_formats

列出所有可用的图像格式预设。

参数：

可用格式

博客平台

社交媒体

视频平台

通用的

PNG元数据

每个生成的PNG图像都包含嵌入的元数据：

查看元数据：

# macOS/Linux
strings your-image.png | grep -E "^(Description|AI-|Title|Creation)"

# Or use exiftool
exiftool your-image.png

安全

此MCP服务器实施了多种安全措施：

• 输入验证：提示的长度经过验证并经过消毒
• 快速注射保护：可疑模式被阻止
• 路径穿越预防：输出路径已验证
• 安全错误消息：API密钥和敏感数据从不在错误中暴露
• 不记录秘密：从未记录API密钥

⚠️ 免责声明

这是一个简单的、用vibe编码的MCP服务器，用于生成图像。 它按原样提供是为了方便和教育目的。

你应该知道什么

1. API密钥安全：您的 GOOGLE_API_KEY 尽可能安全。我们不会将您的API密钥存储、记录或传输到除谷歌API之外的任何地方。您负责：

- 确保API密钥的安全 - 不将其提交到版本控制 - 如果你怀疑它已被攻破，请旋转它

1. 数据传输：您的提示和生成的图像被发送到/来自谷歌的Gemini API。审查 谷歌的人工智能服务条款 他们的数据处理政策。

1. 不担保：本软件按“原样”提供，不提供任何形式的保修。作者对使用本软件引起的任何损害、数据丢失、API费用或其他问题不承担任何责任。

1. API成本：图像生成可能会在您的Google Cloud帐户上产生费用。监控您的使用情况并设置账单提醒。

1. 内容责任：您对提交的提示和生成的图像负责。请勿使用此工具生成有害、非法或违反政策的内容。

许可证

MIT许可证-请参阅 许可证 完整条款。

使用本软件即表示您已阅读并理解这些条款。

添加新提供商

服务器使用提供者接口模式。要添加新提供程序，请执行以下操作：

1. 在中创建新文件 src/providers/ 实施 ImageProvider
2. 在中注册 src/providers/index.ts

// src/providers/my-provider.ts
import { ImageProvider, ImageGenerationOptions, GeneratedImage } from "./types.js";

export class MyProvider implements ImageProvider {
  readonly name = "my-provider";

  isConfigured(): boolean { /* ... */ }
  generateImage(options: ImageGenerationOptions): Promise { /* ... */ }
  getSupportedAspectRatios(): string[] { /* ... */ }
  getMaxResolution(): { width: number; height: number } { /* ... */ }
}

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
GOOGLE_API_KEY=your-key node dist/index.js

# Watch mode
npm run dev

# Run tests
npm test

# Lint and format
npm run lint
npm run format

发布到npm

# 1. Make sure you're logged in to npm
npm login

# 2. Update version in package.json (if needed)
npm version patch  # or minor, major

# 3. Run all checks
npm run check

# 4. Publish
npm publish

# 5. After publishing, users can install with:
#    npx image-generation-mcp
#    or: npm install -g image-generation-mcp

许可证

麻省理工学院