Skip to main content
Glama
deenesjakoruzh
qmediat

ideogram-mcp

by qmediat
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

@qmediat.io/ideogram-mcp

用于 Ideogram V3 API 的 MCP 服务器 — 可从 Claude Code、Claude Desktop 或任何 MCP 客户端生成、编辑、重混、放大和描述图像。

npm version license TypeScript

为什么选择这个服务器？

  • 7 个工具 — 完整的 Ideogram V3 覆盖（生成、编辑、重混、重构图、替换背景、放大、描述）

  • 安全优先 — SSRF 防护、符号链接拒绝、Content-Type 验证、路径遍历防护、Zod 响应验证（详情）

  • 2 个运行时依赖 — @modelcontextprotocol/sdk + zod。无需 axios、form-data 或 HTTP 库

  • 原生 Ideogram API — 直接使用 V3 端点，不通过 fal.ai 或 Replicate 代理

  • 生产级加固 — 指数退避重试、安全过滤器处理、部分失败恢复能力

Related MCP server: ideogram-mcp-server

快速开始

npm install -g @qmediat.io/ideogram-mcp

或直接使用：

npx @qmediat.io/ideogram-mcp

需要 IDEOGRAM_API_KEY — 可在 ideogram.ai/manage-api 获取。

配置

Claude Code

添加到 ~/.claude.json → mcpServers：

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

环境变量

变量

是否必需

默认值

描述

IDEOGRAM_API_KEY

是

—

你的 Ideogram API 密钥（在此获取）

IDEOGRAM_OUTPUT_DIR

否

/tmp/ideogram-output

你想保存图像的任何文件夹。请使用绝对路径（例如 /home/user/images/ideogram）

可用工具

工具

描述

关键参数

ideogram_generate

从文本提示生成图像

prompt, aspect_ratio, rendering_speed, style_type, num_images

ideogram_describe

生成图像的文本描述

image（文件路径）

ideogram_edit

使用基于蒙版的修复编辑图像区域

image, mask, prompt

ideogram_remix

使用新提示转换图像

image, prompt, image_weight (0-100)

ideogram_reframe

将图像扩展到新分辨率（外扩）

image, resolution（69 种有效尺寸）

ideogram_replace_background

替换背景，保留前景

image, prompt

ideogram_upscale

使用引导增强进行放大

image, resemblance (0-100), detail (0-100)

常用参数

参数

可用工具

值

rendering_speed

generate, edit, remix, reframe, replace_background

FLASH, TURBO, DEFAULT, QUALITY

magic_prompt

generate, edit, remix, replace_background, upscale

AUTO, ON, OFF

style_type

generate, edit, remix

AUTO, GENERAL, REALISTIC, DESIGN, FICTION

aspect_ratio

generate, remix

1x1, 16x9, 9x16, 4x3, 3x4 等 10 种

num_images

所有工具

1-8

seed

所有工具

0-2,147,483,647

安全

本服务器采用零信任、最小依赖的设计理念：

  • SSRF 防护 — 仅 HTTPS 下载、主机名白名单、阻止重定向

  • 符号链接拒绝 — lstat() 在读取前拒绝用户创建的符号链接

  • Content-Type 验证 — 下载必须为 image/*，拒绝 HTML/JSON 错误页面

  • Zod 响应验证 — API 响应通过模式解析，不进行盲目类型转换

  • 路径遍历防护 — 扩展名白名单 + path.relative() 包含性检查

完整详情见 SECURITY.md。

开发

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

本地运行：

IDEOGRAM_API_KEY=your-key node dist/index.js

贡献

架构指南和 PR 要求请参阅 CONTRIBUTING.md。

许可证

MIT — Quantum Media Technologies

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • mcp

    Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.

  • mcp

    Generate images with any major model — one API key, one prepaid balance, one MCP.

  • Frenchie

    OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/qmediat/ideogram-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server