MCP 服务器

Ideogram MCP Server

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

Tools

generate_image

Generate an image using Ideogram AI

README

<div align="center">
<img src="assets/header-animation.svg" width="100%">

# 🎨 Ideogram MCP 服务器

<p align="center">
<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/ideogram-mcp-server">
<img alt="npm" src="https://img.shields.io/npm/dt/@sunwood-ai-labs/ideogram-mcp-server">
</p>


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

</div>


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



## 📋 功能

- 基于提示词的图像生成
- 可定制的参数
  - 宽高比
  - 模型选择
  - 魔法提示词
  - 风格类型
  - 负面提示词
  - 生成图像数量

## 🚀 设置

1. 安装所需的依赖项:
```bash
npm install

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

IDEOGRAM_API_KEY=your_api_key_here

构建:

npm run build

(可选) 全局安装:

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: "ideogram-mcp-server",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "ASPECT_16_9",
    model: "V_2",
    num_images: 1
  }
});

🔧 开发

目录结构

ideogram-mcp-server/
├── src/
│   ├── index.ts          # 主要的服务器代码
│   └── ideogram-client.ts # Ideogram API 客户端
├── package.json
├── tsconfig.json
└── README.md