The iRAG MCP Server enables image generation via Baidu's iRAG API through a standardized MCP interface. It allows MCP clients like Claude Desktop to generate custom images with these capabilities:
- Generate images from text prompts with optional reference images
- Select image quantity (1-4 images)
- Choose from multiple dimensions (512x512, 768x768, 1024x768, 1024x1024, 1536x1536, 2048x1152, etc.)
- Switch between models:
irag-1.0
(Baidu's proprietary model) orflux.1-schnell
(faster with advanced controls) - Customize advanced parameters for the
flux.1-schnell
model:- Set random seed for reproducible results
- Configure sampling steps (1-50)
- Adjust guidance density (0-30)
- Configure resource handling (local storage or URL/base64 data)
- Utilize automatic retry mechanisms for failed API requests
- Enable detailed logging for debugging
Integrates with Baidu's iRAG image generation API to create images using different models (irag-1.0, flux.1-schnell), with support for various parameters like size, steps, seed, and guidance.
百度iRAG MCP服务器
一个基于百度iRAG图片生成API的MCP(Model Context Protocol)服务器,允许MCP客户端(如Claude Desktop)通过标准化接口调用百度的图片生成服务。
🚨 重要提醒
在使用前,请务必进行真实API测试!
基础测试只验证服务器启动,要确保完全可用,需要:
- 获取真实的百度API Key
- 运行
npm run test:api
进行真实API测试 - 验证图片生成和Base64转换功能
详细设置指南请查看:FINAL_SETUP.md
功能特性
- 🎨 支持百度iRAG图片生成API
- 🔧 完整的MCP协议实现
- 📝 支持多种模型(irag-1.0, flux.1-schnell)
- 🖼️ 灵活的图片尺寸配置
- 🔄 自动重试机制
- 📊 完善的日志记录
- ✅ 全面的参数验证
- 🧪 完整的测试覆盖
支持的模型
- irag-1.0: 百度自研的图片生成模型
- flux.1-schnell: 支持更多高级参数的快速生成模型
安装
前置要求
- Node.js >= 18.0.0
- npm 或 yarn
克隆项目
安装依赖
构建项目
配置
1. 获取百度API Key
- 访问百度智能云控制台
- 创建API Key并选择千帆ModelBuilder
- 配置对应的应用资源
- 复制API Key(格式:
bce-v3/ALTAK-****/****
)
2. 环境变量配置
复制环境变量模板:
编辑 .env
文件:
图片保存配置说明
- RESOURCE_MODE=local: 图片将保存到本地文件系统,同时返回base64数据和文件路径
- RESOURCE_MODE=url: 仅返回图片URL和base64数据,不保存本地文件
- BASE_PATH: 自定义图片保存路径,留空则使用默认路径(用户桌面/irag-images文件夹)
- MODEL: 设置默认使用的图片生成模型
irag-1.0
: 百度自研模型,通用性好,速度快flux.1-schnell
: 支持更多高级参数,质量更高
使用方法
启动服务器
MCP客户端配置
Claude Desktop配置
在Claude Desktop的配置文件中添加:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
API参考
generate_image 工具
生成图片的MCP工具。
参数
参数名 | 类型 | 必需 | 默认值 | 描述 |
---|---|---|---|---|
prompt | string | ✅ | - | 图片生成提示词 |
refer_image | string | ❌ | - | 参考图片URL |
n | integer | ❌ | 1 | 生成图片数量(1-4) |
size | string | ❌ | 1024x1024 | 图片尺寸 |
steps | integer | ❌ | - | 采样步数(1-50,仅flux.1-schnell) |
seed | integer | ❌ | - | 随机种子(仅flux.1-schnell) |
guidance | number | ❌ | 3.5 | 指导密度值(0-30,仅flux.1-schnell) |
注意: 模型通过配置文件的MODEL
参数设置,不在请求中指定。
支持的图片尺寸
512x512
,768x768
,1024x768
,1024x1024
使用示例
开发
项目结构
开发命令
测试
运行所有测试:
查看测试覆盖率:
故障排除
常见问题
- API Key无效
- 确保API Key格式正确:
bce-v3/ALTAK-****/****
- 检查API Key是否已配置千帆ModelBuilder资源
- 确保API Key格式正确:
- 连接超时
- 检查网络连接
- 增加
API_TIMEOUT
配置值
- 图片生成失败
- 检查提示词是否符合要求
- 确认模型参数配置正确
- Base64验证错误
- 服务器会自动下载图片并转换为base64格式
- 如果下载失败,会返回错误信息和原始URL
- 检查网络连接和图片URL的可访问性
- MCP客户端连接问题
- 确保Claude Desktop配置文件路径正确
- 检查Node.js版本(需要>=18.0.0)
- 验证项目已正确构建(运行
npm run build
)
日志调试
设置日志级别为debug:
查看详细的API调用日志和图片下载过程。
许可证
MIT License
贡献
欢迎提交Issue和Pull Request!
更新日志
v1.0.0
- 初始版本发布
- 支持百度iRAG图片生成API
- 完整的MCP协议实现
- 支持多种模型和参数配置
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A Model Context Protocol server that enables Claude Desktop to generate images using Baidu's iRAG image generation API through a standardized interface.
Related MCP Servers
- -securityAlicense-qualityModel Context Protocol server that enables Claude Desktop (or any MCP client) to fetch web content and process images appropriately.Last updated -11MIT License
Letz AI MCPofficial
AsecurityFlicenseAqualityA Model Context Protocol server that enables Claude to generate and upscale images through the Letz AI API, allowing users to create images directly within Claude conversations.Last updated -21JavaScript- AsecurityAlicenseAqualityA server that enables Claude Desktop to generate images using Google's Gemini AI models through the Model Context Protocol (MCP).Last updated -76JavaScriptMIT License
302AI BrowserUse MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude Desktop to browse the web, likely allowing the AI to access and interact with web content.Last updated -2935JavaScriptMIT License