AI导哈

文本转图像生成服务

ModelsLab Text2Image MCP Server是一个基于ModelsLab API的文本到图像生成专用服务器，支持多种AI模型并可将生成的图像自动保存到本地。

  • by shimizu
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 shimizu/modelslab-text2img-mcp-server

使用说明

🎨 模型实验室文本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-server

2.安装相关性

npm install

3. ModelsLab API设定🔑

  1. 📝 模型实验室创建帐户
  2. 🆔 API获取密钥
  3. 🔧 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 dev

Claude 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驱动的图像生成

相关 MCP