@qmediat.io/表意文字-mcp
MCP服务器 Ideogram V3 API --生成、编辑、混音、升级和描述来自Claude Code、Claude Desktop或任何MCP客户端的图像。
](https://www.npmjs.com/package/@qmediat.io/ideogram-mcp)  
为什么是这个服务器？
- 7工具 --完整的Ideogram V3覆盖范围（生成、编辑、混音、重新构建、替换背景、升级、描述）
- 安全第一 --SSRF保护、符号链接拒绝、内容类型验证、路径遍历预防、Zod响应验证(详情)
- 2个运行时依赖关系 —
@modelcontextprotocol/sdk+zod.没有axios，没有表单数据，没有HTTP库 - 本机Ideogram API --直接V3端点，不通过fal.ai或Replicate代理
- 生产硬化 --使用指数回退、安全过滤器处理、部分故障恢复功能重试
快速开始
npm install -g @qmediat.io/ideogram-mcp或直接使用：
npx @qmediat.io/ideogram-mcp需要 IDEOGRAM_API_KEY --得到一个在 表意ai/管理api.
配置
克劳德代码
添加 ~/.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_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 | 生成、编辑、混音、重构、替换背景 | FLASH, TURBO, DEFAULT, QUALITY |
magic_prompt | 生成、编辑、混音、替换背景、升级 | AUTO, ON, OFF |
style_type | 生成、编辑、混音 | AUTO, GENERAL, REALISTIC, DESIGN, FICTION |
aspect_ratio | 生成、混音 | 1x1, 16x9, 9x16, 4x3, 3x4，还有10个 |
num_images | 所有工具 | 1-8 |
seed | 所有工具 | 0-2,147,483,647 |
安全
此服务器采用零信任、最小依赖的方法设计：
- SSRF保护 --仅HTTPS下载、主机名分配列表、重定向阻止
- Symlink拒绝 —
lstat()阅读前拒绝用户创建的符号链接 - 内容类型验证 --下载必须
image/*，拒绝HTML/JSON错误页面 - Zod响应验证 -API响应通过架构解析，无盲类型强制转换
- 路径遍历预防 --扩展异体+
path.relative()安全壳检查
详细信息请参见 安全.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贡献
看 贡献.md 架构指南和PR要求。