意图图谱-MCP服务器

Name: 意图图谱-MCP服务器
Author: Sunwood-ai-labs

作者：Sunwood-ai-labs5 星标更新：2025-05-18

安装使用来源：spider==github.com

项目介绍

<h1>🎨 Ideogram MCP 服务器</h1> <p> <img alt="GitHub" src="https://img.shields.io/github/license/sunwood-ai-labs/ideagram-mcp-server"> <img alt="GitHub package.json version" src="https://img.shields.io/github/package-json/v/sunwood-ai-labs/ideagram-mcp-server"> <img alt="GitHub issues" src="https://img.shields.io/github/issues/sunwood-ai-labs/ideagram-mcp-server"> <img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/sunwood-ai-labs/ideagram-mcp-server"> <img alt="npm" src="https://img.shields.io/npm/v/@sunwood-ai-labs/ideagram-mcp-server"> <img alt="npm" src="https://img.shields.io/npm/dt/@sunwood-ai-labs/ideagram-mcp-server"> </p> <p> 通过 Ideogram API 提供图像生成服务的 Model Context Protocol (MCP) 服务器。<br> 支持 <b>Ideogram 3.0</b>，可以快速与 Claude Desktop 或其他 MCP 客户端集成！✨ </p> </div>

📦 项目概述

一个通过 MCP 服务器使用 Ideogram API (v3.0) 的 TypeScript 工具
具有多种功能，包括图像生成、风格参考、魔法提示、宽高比选择、模型选择等
可以立即在 Claude Desktop 或其他 MCP 客户端中使用

⚡️ 快速开始

想要快速与 Claude Desktop 或其他 MCP 客户端集成，请将以下 JSON 片段复制到配置文件中！✨

{
  "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" 等）	可选	15 种类型
resolution	string	分辨率（参见官方文档，共 69 种）	可选
seed	integer	随机种子（用于保证再现性）	可选	范围：0～2147483647
magic_prompt	string	魔法提示（"AUTO"	"ON"	"OFF"）
rendering_speed	string	v3 渲染速度（"TURBO"	"DEFAULT"	"QUALITY"）
style_codes	string[]	8 位风格代码数组	可选
style_type	string	风格类型（"AUTO"	"GENERAL"	"REALISTIC"
negative_prompt	string	排除元素（推荐英文）	可选
num_images	number	生成图像数量（1～8）	可选
style_reference	object	风格参考（Ideogram 3.0 新功能）	可选	详情如下
└ urls	string[]	参考图像 URL 数组（最多 3 个）	可选
└ style_code	string	风格代码	可选
└ random_style	boolean	使用随机风格	可选
output_dir	string	图像保存目录（默认："docs"）	可选
base_filename	string	保存文件名基础（默认："ideogram-image"）	可选	添加时间戳或 ID
blur_mask	boolean	模糊图像边缘（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
└── ...（省略）

📝 贡献指南

Fork 本仓库
创建新分支 (git checkout -b feature/awesome)
提交更改（建议使用日语加表情符号的提交信息！）
推送并创建 Pull Request

🚀 部署 & 发布

通过 GitHub Actions 自动发布 npm 包
更新版本号并推送标签以实现自动部署

npm version patch|minor|major
git push --follow-tags

详细信息请参阅 docs/npm-deploy.md！

📄 许可证

MIT

</div>