意象生成器-MCP服务器

@Sunwood-ai-labs/ideagram-mcp-server
0 Stars 342 次浏览 Sunwood-ai-labs 更新于 2026-08-23

一个模型上下文协议服务器,使用Ideogram API提供图像生成功能,允许用户通过可自定义参数的文本提示创建图像。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "ideogram": {
      "args": [
        "@sunwood-ai-labs/ideagram-mcp-server"
      ],
      "command": "npx",
      "env": {
        "IDEOGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

该服务需要配置环境变量:IDEOGRAM_API_KEY

可用工具 (1 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

generate_image 7 个参数 需填 1 项

Generate an image using Ideogram AI

必填参数:prompt

服务介绍

🎨 Ideogram MCP Server

使用Ideogram API提供图像生成功能的Model Context Protocol (MCP) 服务器

https://github.com/user-attachments/assets/041553d3-6fbc-4dfa-b149-d195dcb9e8f8

📋 功能

  • 基于提示生成图像
  • 可定制参数
    • 纵横比
    • 模型选择
    • 魔法提示
    • 样式类型
    • 负面提示
    • 生成图片数量

🚀 设置

  1. 安装所需的依赖:
npm install
  1. 设置环境变量:
    创建.env文件,并添加以下内容:
IDEOGRAM_API_KEY=your_api_key_here
  1. 构建:
npm run build
  1. (可选)全局安装:
npm link

💻 使用方法

MCP 工具

generate_image

用于生成图像的工具。

必填参数:

  • prompt: 用于生成图像的提示

可选参数:

  • aspect_ratio: 图像的纵横比
    • ASPECT_1_1
    • ASPECT_4_3
    • ASPECT_3_4
    • ASPECT_16_9
    • ASPECT_9_16
  • model: 使用的模型
    • V_1
    • V_1_TURBO
    • V_2
    • V_2_TURBO
  • magic_prompt_option: 魔法提示设置
    • AUTO
    • ON
    • OFF
  • style_type: 生成样式
  • negative_prompt: 不希望包含元素的描述
  • num_images: 生成的图像数量(1-8)

示例

const result = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "ASPECT_16_9",
    model: "V_2",
    num_images: 1
  }
});

🔧 开发

目录结构

ideagram-mcp-server/
├── src/
│   ├── index.ts          # メインのサーバーコード
│   └── ideogram-client.ts # Ideogram APIクライアント
├── package.json
├── tsconfig.json
└── README.md

脚本

  • npm run build: 编译TypeScript
  • npm run watch: 在开发模式下运行(监视文件更改)
  • npm run lint: 代码检查
  • npm test: 运行测试

📄 许可证

MIT

🤝 贡献

  1. Fork此仓库
  2. 创建一个新的分支 (git checkout -b feature/amazing-feature)
  3. 提交你的更改 (git commit -m '✨ feat: Add amazing feature')
  4. 将分支推送到远程 (git push origin feature/amazing-feature)
  5. 创建一个Pull Request

相关 MCP 服务