Jimengpic MCP

🚀 即梦AI画像生成MCPサービス

このサービスは、火山エンジンの即梦AIをベースにした画像生成MCP（Model Context Protocol）サービスです。即梦AIの強力な機能を利用して、高品質な画像生成を実現します。

✨ 主な機能

• 火山エンジンの即梦AI APIを使用して、高品質な画像を生成します。
• 4:3、3:4、16:9、9:16など、様々な画像比率に対応しています。
• 標準化されたMCPインターフェースを備え、様々な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 を使用してください。

💻 使用例

直接実行

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"
      }
    }
  }
}

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と詳細情報が返されます。
• 失敗時：エラーメッセージが返されます。

コード例

// MCPクライアントでの呼び出し例
const result = await mcp.callTool("generate-image", {
  text: "新年おめでとう",
  illustration: "花火, 提灯, 祥雲, 星, 礼花",
  color: "赤色",
  ratio: "4:3"
});

📚 ドキュメント

プロジェクト構造

jimengpic-mcp/
├── src/
│   └── index.ts          # メインサービスファイル
├── build/                # コンパイル出力ディレクトリ
├── package.json          # プロジェクト設定
├── tsconfig.json         # TypeScript設定
└── README.md            # プロジェクト説明

注意事項

1. 火山エンジンAPIにアクセスできるよう、正常なネットワーク接続を確保してください。
2. API呼び出しにはポイントが必要ですので、使用量に注意してください。
3. 生成された画像のURLには有効期限がありますので、できるだけ早くダウンロードして保存することをおすすめします。
4. 火山エンジンの利用規約と即梦AIのコンテンツポリシーに従って使用してください。

トラブルシューティング

一般的なエラー

1. 環境変数が設定されていない：正しいACCESS_KEYとSECRET_KEYが設定されていることを確認してください。
2. ネットワーク接続の問題：ネットワーク接続とファイアウォール設定を確認してください。
3. APIクォータが不足している：火山エンジンのアカウント残高とAPI呼び出し回数を確認してください。
4. プロンプトが規制に違反している：プロンプトがコンテンツセキュリティ規範に準拠していることを確認してください。

デバッグ方法

実行時にデバッグ情報を追加するには、以下のコマンドを使用します。

DEBUG=* node build/index.js

📄 ライセンス

ISC License