Jimengpic MCP

🚀 即夢AI圖片生成MCP服務

即夢AI圖片生成MCP服務基於火山引擎即夢AI，藉助標準化的MCP接口，為用戶提供高質量的圖片生成能力，支持多種圖片比例，配置安全便捷。

🚀 快速開始

要使用即夢AI圖片生成MCP服務，需完成依賴安裝、項目編譯和環境變量配置。

安裝依賴

cd jimengpic-mcp
npm install

編譯項目

npm run build

環境變量配置

設置以下環境變量：

export JIMENG_ACCESS_KEY="你的火山引擎AccessKey"
export JIMENG_SECRET_KEY="你的火山引擎SecretKey"

獲取API密鑰

1. 訪問 火山引擎控制檯
2. 登錄後進入"即夢AI"產品頁面，開通服務（可選擇免費試用）
3. 在"訪問控制"頁面創建訪問密鑰，獲取Access Key和Secret Key
4. 確保賬號已開通即夢AI圖像生成相關權限和策略

注意：根據官方文檔，請確保使用正確的req_key參數值 jimeng_high_aes_general_v21_L

✨ 主要特性

• 高質量圖片生成：使用火山引擎即夢AI API生成高質量圖片。
• 多種圖片比例支持：支持4:3、3:4、16:9、9:16等多種圖片比例。
• 標準化接口：採用標準化的MCP接口，兼容各種MCP客戶端。
• 安全便捷配置：通過環境變量配置，安全便捷。

📦 安裝指南

安裝依賴和編譯項目的步驟如下：

# 進入項目目錄
cd jimengpic-mcp
# 安裝依賴
npm install
# 編譯項目
npm run build

💻 使用示例

基礎用法

直接運行

node build/index.js

作為MCP服務器

在MCP客戶端（如Claude Desktop、Cursor等）中配置此服務：

{
  "mcpServers": {
    "jimengpic": {
      "command": "node",
      "args": ["/path/to/jimengpic-mcp/build/index.js"],
      "env": {
        "JIMENG_ACCESS_KEY": "你的AccessKey",
        "JIMENG_SECRET_KEY": "你的SecretKey"
      }
    }
  }
}

高級用法

在MCP客戶端中調用API接口生成圖片：

// 在MCP客戶端中調用
const result = await mcp.callTool("generate-image", {
  text: "新年快樂",
  illustration: "煙花, 燈籠, 祥雲, 星星, 禮花",
  color: "紅色",
  ratio: "4:3"
});

📚 詳細文檔

API接口

generate-image

當用戶需要生成圖片時使用的工具。

參數：

• text (string)：用戶需要在圖片上顯示的文字。
• illustration (string)：根據用戶要顯示的文字，提取3 - 5個可以作為圖片配飾的插畫元素關鍵詞。
• color (string)：圖片的背景主色調。
• ratio (enum)：圖片比例，支持以下選項：
  • "4:3"：512×384
  • "3:4"：384×512
  • "16:9"：512×288
  • "9:16"：288×512

提示詞生成規則： 工具會自動將輸入參數組合成以下格式的提示詞：

字體設計："{text}"，黑色字體，斜體，帶陰影。乾淨的背景，白色到{color}漸變。點綴淺灰色、半透明{illustration}等元素插圖做配飾插畫。

返回：

• 成功時返回圖片URL和詳細信息。
• 失敗時返回錯誤信息。

🔧 技術細節

項目結構

jimengpic-mcp/
├── src/
│   └── index.ts          # 主服務文件
├── build/                # 編譯輸出目錄
├── package.json          # 項目配置
├── tsconfig.json         # TypeScript配置
└── README.md            # 項目說明

📄 許可證

本項目採用ISC License。

⚠️ 重要提示

• 確保網絡連接正常，能夠訪問火山引擎API。
• API調用需要消耗積分，請注意使用量。
• 生成的圖片URL有時效性，建議及時下載保存。
• 請遵守火山引擎的使用條款和即夢AI的內容政策。

💡 使用建議

故障排除

常見錯誤

• 環境變量未設置：確保設置了正確的ACCESS_KEY和SECRET_KEY。
• 網絡連接問題：檢查網絡連接和防火牆設置。
• API配額不足：檢查火山引擎賬戶餘額和API調用次數。
• 提示詞不合規：確保提示詞符合內容安全規範。

調試方法

運行時添加調試信息：

DEBUG=* node build/index.js