Name: Ideogram MCP Server
Author: Sunwood-ai-labs

📦项目概述

一个 TypeScript 工具，允许您通过 MCP 服务器使用 Ideogram API (v3.0)
多功能包括图像生成、样式参考、魔法提示、长宽比、模型选择等。
可立即与 Claude Desktop 和其他 MCP 客户端一起使用

Related MCP server: Image Generation MCP Server

⚡️ 快速入门

如果你想以闪电般的速度连接到 Claude Desktop 或其他 MCP 客户端，
只需将下面的 JSON 代码片段复制并粘贴到您的配置文件中！ ✨

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

🛠️ MCP 工具规格

生成图像

参数列表（最新版本）

参数	类型	解释	必需/可选	评论
迅速的	细绳	图像生成提示（建议使用英文）	必需的
纵横比	细绳	长宽比（例如“1x1”、“16x9”、“4x3”等）	任何	15种
解决	细绳	分辨率（参见官方文档，共69种）	任何
种子	整数	随机数种子（确保可重复性）	任何	0 到 2147483647
magic_prompt	细绳	魔术提示（“AUTO”	“在”	“离开”
渲染速度	细绳	v3 的渲染速度（“TURBO”	“默认”	“质量”
样式代码	细绳[]	8 个字符的样式代码序列	任何
样式类型	细绳	样式类型（“AUTO”	“一般的”	“实际的”
负面提示	细绳	除外责任（建议使用英语）	任何
图像数量	数字	生成的图像数量（1 至 8）	任何
样式参考	目的	样式参考（表意文字 3.0 中的新功能）	任何	详情如下
└ 网址	细绳[]	参考图像 URL 数组（最多 3 个）	任何
└ 样式代码	细绳	样式代码	任何
└ 随机风格	布尔值	使用随机样式	任何
输出目录	细绳	图片存储目录（默认：“docs”）	任何
基本文件名	细绳	保存文件名的基础（默认值：“ideogram-image”）	任何	时间戳和ID分配
模糊蒙版	布尔值	模糊图像边缘（设置为 true 以进行蒙版合成）	任何	默认值：false

📝 使用示例

const result = await use_mcp_tool({ server_name: "ideagram-mcp-server", tool_name: "generate_image", arguments: { prompt: "A beautiful sunset over mountains", aspect_ratio: "16x9", rendering_speed: "QUALITY", num_images: 2, style_reference: { urls: [ "https://example.com/ref1.jpg", "https://example.com/ref2.jpg" ], random_style: false }, blur_mask: true } });

🧑‍💻 开发、构建和测试

npm run build ... TypeScript 构建
npm run watch ... 开发模式（自动构建）
npm run lint ... 代码检查
npm test ...运行测试

🗂️ 目录结构

ideagram-mcp-server/ ├── assets/ ├── docs/ │ └── ideogram-image_2025-05-18T06-31-45-777Z.png ├── src/ │ ├── tools/ │ ├── types/ │ ├── utils/ │ ├── ideogram-client.ts │ ├── index.ts │ ├── server.ts │ └── test.ts ├── .env.example ├── package.json ├── tsconfig.json ├── README.md └── ...（省略）