🎨 模型实验室文本2图像MCP服务器\[草稿\]
⚠️ 注意：此项目当前为草稿版本。在生产环境中使用前，请进行充分的测试。
ModelsLab API使用Text2Image图像生成专用Model Context Protocol (MCP)服务器。Claude Code高质量的AI可以简单地执行图像生成。
🚀 主要机能
- 🎭 Flux标准机型 -默认为最新Flux使用模型
- 🌈 支持多模型 - Flux、Stable Diffusion、Midjourney等支持
- 📁 本地保存 -将生成的图像自动保存到本地文件
- 🔧 丰富的设置 -精细调整图像尺寸、质量、样式等
- 🔒 安全 - API内置密钥安全管理功能
📦 安装和配置
1.克隆存储库
git clone https://github.com/shimizu/modelslab-text2img-mcp-server.git
cd modelslab-text2img-mcp-server2.安装相关性
npm install3. ModelsLab API设定🔑
- 📝 模型实验室创建帐户
- 🆔 API获取密钥
- 🔧 API设置关键帧：
# APIキー設定ファイルを作成
cp src/config/api-keys.example.js src/config/api-keys.js
# api-keys.jsを編集してAPIキーを設定
# apiKey: 'your_modelslab_api_key_here' を実際のキーに変更重要: src/config/api-keys.js 表示GitHub在…之上push不受保护（受.gitignore保护）
4.服务器启动⚡
# MCPサーバーを起動
npm start
# MCP Inspectorで開発・テスト
npm run devClaude Code 在中使用
Claude Code 那么，那么 claude mcp add 在工作空间的边缘MCP注册服务器：
# プロジェクトに移動
cd /path/to/modelslab-text2img-mcp-server
# 実行権限を付与（初回のみ必要）
chmod +x src/index.js
# MCPサーバーを登録（ローカルスコープ）
claude mcp add modelslab-text2img node src/index.js
# または絶対パスで登録
claude mcp add modelslab-text2img node /path/to/modelslab-text2img-mcp-server/src/index.js了解更多信息 Claude Code MCP 文档 来修改标记元素的显示属性。
使用开始
claude启动后/mcp执行命令MCP请确认是否正确连接。
✔ connected的规格化距离的幂函数。
💬 Claude使用示例
🎨 基本图像生成
美しい夕焼けの山景色の画像を生成してください🎭 指定特定模型
midjourney モデルを使用して、アニメスタイルのキャラクターポートレートを生成してください🖼️ 生成多个图像
「未来都市」をテーマに、2枚の画像を生成して保存してください🔧 在高级配置中生成
以下の設定で画像を生成してください：
- プロンプト: "cyberpunk city at night, neon lights, rain"
- サイズ: 1024x768
- 品質: 高品質
- ネガティブプロンプト: "blurry, low quality"🛠️ 可用工具
🎨 modelslab_text2img
从文本提示生成高质量图像
参数：
prompt(string, required): 图像生成文本提示model_id(string, optional): 要使用的模型（默认值：“flux”）width(number, optional): 图像宽度（默认值：512）height(number, optional): 图像高度（默认值：512）samples(number, optional): 要生成的图像数（默认值：1）negative_prompt(string, optional): 负提示num_inference_steps(number, optional): 推理步数（默认值：20）guidance_scale(number, optional): 指导比例（默认值：7.5）outputPath(string, optional): 目标文件路径format(string, optional): 画像形式（jpg, png, webp等）
使用例:
{
"prompt": "beautiful landscape at sunset",
"model_id": "flux",
"width": 1024,
"height": 512,
"samples": 1,
"outputPath": "./generated_landscape.jpg"
}👋 你好
简单的行为检查工具
🔗 test_连接
HTTP连接测试工具
📋 响应格式
🎨 图像生成结果（有文件保存）
{
"status": "success",
"message": "画像をファイルに保存しました",
"file": "./generated_image.jpg",
"size": "245.67 KB",
"contentType": "image/jpeg",
"format": "jpg",
"model": "flux",
"prompt": "beautiful landscape at sunset",
"dimensions": "1024x512",
"samples": 1
}🌐 图像生成结果（仅URL）
{
"success": true,
"imageUrls": [
"https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/generations/image1.jpg"
],
"metadata": {
"tool": "modelslab_text2img",
"timestamp": "2024-01-01T12:00:00.000Z",
"imageCount": 1,
"model": "flux"
}
}🗂️ 项目结构
📁 modelslab-text2img-mcp-server/
├── 📄 src/
│ ├── 🎯 index.js # エントリーポイント
│ ├── 🔌 adapters/ # APIアダプター
│ │ └── 🎨 modelslab/
│ │ ├── ModelsLabClient.js # ModelsLab APIクライアント
│ │ └── config.js # API設定
│ ├── 🖥️ server/ # MCPサーバー実装
│ │ ├── DataDownloadServer.js
│ │ └── config.js
│ ├── ⚙️ core/ # 基底クラス
│ │ ├── DataSourceClient.js
│ │ └── ToolBase.js
│ ├── 🛠️ tools/ # MCPツール
│ │ ├── index.js
│ │ ├── modelslab_text2img.js # 画像生成ツール
│ │ ├── hello.js
│ │ └── test_connection.js
│ ├── 🔧 utils/ # ユーティリティ
│ │ └── modelslab-image-handler.js # 画像処理
│ └── 📁 config/ # 設定ファイル
│ └── api-keys.example.js # APIキーテンプレート
├── 📖 docs/ # ドキュメント
│ └── modelslab-text2img.md
├── 📦 package.json
├── 📖 README.md
└── 📝 CLAUDE.md🌟 支持的模型
- 通量 -最新的高质量图像生成模型（默认值）
- 稳定扩散 -通用图像生成模型
- 中途 -艺术图像生成
- 其他 - ModelsLab中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积
🚨 注意事项
- 🆔 API密钥必需: ModelsLab API需要密钥
- 🖼️ 画像制限：最大尺寸为1024x768或768x1024（内存限制）
- 📊 汇率限制: API中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积
- 🔒 安全性:
src/config/api-keys.js绝对不要提交（受.gitignore保护）
🆘 故障排除
API键错误
ModelsLab API key is not configured→ src/config/api-keys.js检查文件API确认密钥是否正确设置
图像生成错误
The temp field must be true or false→检查参数的类型是否正确。不是字符串boolean使用
连接错误
timeout of 30000ms exceeded-网络连接和ModelsLab API检查服务状态
📄 许可证
MIT许可证
🤝 分发
Issues、Pull Requests非常欢迎！
______________________________________________________________________
由以下材料制成❤️ 用于AI驱动的图像生成