使用说明
Ideogram MCP服务器
Ideogram AI API的模型上下文协议(MCP)服务器实现。该服务器提供使用Ideogram强大的AI模型生成、编辑和描述图像的工具。
特性
- 根据文本描述生成图像
- 使用遮罩编辑现有图像
- 为图像生成描述
- 将生成的图像下载到本地目录
- 常见操作的提示模板
安装
- 克隆存储库
git clone https://github.com/flowluap/ideogram-mcp-server.git
cd ideogram-mcp-server
- 安装依赖项
npm install
- 构建项目
npm run build
光标集成
要在游标中使用此MCP,请将以下配置添加到游标设置中(设置>AI>模型上下文协议):
{
"mcps": {
"ideogram-mcp": {
"command": "node",
"args": ["PATH_TO_YOUR_DIST/index.js"],
"env": {
"IDEOGRAM_API_KEY": "your-api-key-here"
}
}
}
}
替换:
PATH_TO_YOUR_DIST/index.js与您的建筑绝对路径index.js文件your-api-key-here使用您的实际Ideogram API密钥
示例(已编辑):
{
"mcps": {
"ideogram-mcp": {
"command": "node",
"args": ["/path/to/ideogram-mcp-server/dist/index.js"],
"env": {
"IDEOGRAM_API_KEY": "xxxxx-REDACTED-xxxxx"
}
}
}
}
可用工具
-
generate- 根据文本提示生成图像
- 参数:
prompt:string(必填)aspect_ratio:string(可选)-以下选项之一:ASPECT_1_1、ASPECT_16_9、ASPECT_9_16、ASPECT4_3、ASPECT_3_4model:string(可选)-V_1、V_2、V_2_TURBO之一magic_prompt_option:string(可选)-以下选项之一:AUTO、ON、OFFnum_images:number(可选)-介于1和8之间seed:number(可选)-介于0和2147483647之间
-
edit- 使用遮罩编辑图像
- 参数:
image_file:string(必需)-Base64或文件路径mask:string(必需)-Base64或文件路径prompt:string(必填)model:string(必填)-V_2、V_2_TURBO之一
-
describe- 为图像生成描述
- 参数:
image_file:string(必需)-Base64或文件路径
-
download_images- 将生成的图像下载到本地目录
- 参数:
urls:string[](必填)-图像URL数组output_dir:string(必需)-输出目录路径
提示模板
generate_image- 用于生成图像的模板
- 参数:
description:string
发展
# Build the project
npm run build
# Run in development mode
npm run dev
# Run tests
npm test
# Run linter
npm run lint
需求
- Node.js>=18.0.0
- Ideogram API密钥
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
贡献
- 分叉存储库
- 创建功能分支
- 提交您的更改
- 推到分支
- 创建新的Pull请求