🎨 Ideogram MCP Server
Ideogram APIを使って画像生成を提供するModel Context Protocol (MCP) サーバーだよ！
Ideogram 3.0対応で、Claude DesktopやMCPクライアントから爆速連携できるのが神✨
______________________________________________________________________
📦 项目简介
- Ideogram API (v3.0) 打开MCP通过服务器使用TypeScript制工具
- 图像生成、样式参照、魔术提示、纵横比、模型选择等多功能
- Claude Desktop或其他MCP立即从客户端使用OK
______________________________________________________________________
⚡快速启动
Claude Desktop或其他MCP如果你想在客户端进行爆速合作\ 下列JSON将片段复制到配置文件OK！✨
{
"mcpServers": {
"ideogram": {
"command": "npx",
"args": [
"@sunwood-ai-labs/ideagram-mcp-server"
],
"env": {
"IDEOGRAM_API_KEY": "your_api_key_here"
}
}
}
}______________________________________________________________________
🛠️ MCP工具规格
generate_image
参数列表（最新版）
｜参数｜类型｜说明｜必需/任意｜备注｜ |--------------------|------------|--------------------------------------------------------------------------------------|-----------|---------------------------| | prompt | string | 图像生成提示（建议使用英语）｜必需｜ | aspect_ratio | string | 长宽比（例如：“1x1”、“16x9”、“4x3”等） | resolution | string | 分辨率（参照官方文档，共69种）｜任意｜ | seed | integer | 随机数种子（可重复性担保）｜任意｜0～2147483647｜ | magic_prompt | string | 魔术提示（“AUTO”｜“ON”｜“OFF”）｜任意｜默认“AUTO”｜ | rendering_speed | string | v3用渲染速度（“TURBO”｜“DEFAULT”｜“QUALITY”）｜任意｜ | style_codes | string\[\] | 8字符样式代码数组 | style_type | string | 样式类型（“AUTO”｜“GENERAL”｜“REALISTIC”｜“DESIGN”）｜任意｜ | negative_prompt | string | 除外要素（英语推奨）|任意| | | num_images | number | 生成画像数（1～8） | 任意 | | | style_reference | object | 样式参照（Ideogram3.0新功能）｜任意｜下述详细内容｜ | └ urls | string\[\] | 参照画像URL配列（最大3つ） | 任意 | | | └ style_code | string | 样式代码｜可选｜ | └ random_style | boolean | 使用随机样式｜可选｜ | output_dir | string | 图像保存目录（默认值：“docs”）｜任意｜ | base_filename | string | 保存文件名的基础（默认值：“ideogram-image”）ID授予 | blur_mask | boolean | 模糊图像边缘（以真为单位合并遮罩）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
└── ...（省略）______________________________________________________________________
📝 分发
- 分叉此存储库
- 创建新分支（
git checkout -b feature/awesome) - 变更提交（提交信息为日语+图画文字推荐！）
- 创建推拉
______________________________________________________________________
🚀 部署和发布
- GitHub Actions自动npm发布
- 版本更新-标记push自动部署
npm version patch|minor|major
git push --follow-tags了解更多信息 查看项目中可用的所有族！
______________________________________________________________________
📄 许可证
麻省理工学院
______________________________________________________________________
