Sunwood-ai-labs_ideagram-mcp-server

🚀 伊甸园 MCP 服务器

伊甸园 MCP 服务器借助 Ideogram API 提供图像生成功能，是一款基于 Model Context Protocol (MCP) 的服务器，能依据用户需求生成个性化图像。

🚀 快速开始

环境搭建

1. 安装所需的依赖项：

npm install

2. 设置环境变量： 创建 .env 文件并添加以下内容：

IDEOGRAM_API_KEY=your_api_key_here

3. 构建项目：

npm run build

4. （可选）全局安装：

npm link

✨ 主要特性

• 基于提示词的图像生成：根据用户输入的提示词生成相应图像。
• 可自定义参数：
  • 宽高比：提供多种宽高比选项，如 ASPECT_1_1、ASPECT_4_3 等。
  • 模型选择：支持 V_1、V_1_TURBO、V_2、V_2_TURBO 等模型。
  • 魔法提示词：有 AUTO、ON、OFF 三种设置。
  • 风格类型：可指定生成图像的风格。
  • 负面提示词：用于排除图像中不需要的要素。
  • 生成图像数量：可指定生成 1 - 8 张图像。

💻 使用示例

基础用法

MCP 工具 - generate_image

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
  }
});

🔧 技术细节

项目结构

伊甸园 MCP 服务器
├── src
│   ├── services          # API 请求处理
│   ├── models            # 模型定义
│   ├── routes            # 路由定义
│   └── middleware        # 中间件
└── package.json         # 项目依赖和脚本

如何贡献

1. Fork 该项目到您的仓库。
2. 在您的本地仓库中创建新的功能分支：git checkout -b feature/your-feature-name
3. 提交您的更改：git add . && git commit -m "添加新功能：你的功能名称"
4. 将您的分支推送到远程仓库：git push origin feature/your-feature-name
5. 创建 Pull Request 到主仓库。

📄 许可证

项目许可证