Pollinations Multimodal

🚀 MCPollinations MCP サーバー

MCPollinations MCP サーバーは、強力な機能を備えたツールです。以下の機能をサポートしています。

• 画像生成：異なるモデル（デフォルトは 'flux'）を使用して高品質な画像を生成し、カスタムサイズ、ランダムシード、コンテンツフィルタリングをサポートします。
• テキスト応答：MCP プロトコルを通じてクライアントアプリケーション（Claude Desktop など）とやり取りし、テキストコマンドを処理します。
• 音声生成：さまざまな音声オプションを提供し、音声コンテンツを生成します。
• モデル管理：柔軟なモデル選択と画像形式の設定をサポートします。

🚀 クイックスタート

✨ 主な機能

MCPollinations MCP サーバーは、以下の主要な機能を提供します。

1. 画像生成：様々なモデル（デフォルトは 'flux'）を使って高品質な画像を生成でき、画像のサイズ、シード値、コンテンツフィルタリングなどをカスタマイズできます。
2. テキスト応答：MCP プロトコルを介してクライアントアプリ（Claude Desktop など）と通信し、テキストコマンドを処理します。
3. 音声生成：複数の音声オプションを提供し、音声コンテンツを生成します。
4. モデル管理：柔軟なモデル選択と画像形式の設定が可能です。

📦 インストール

インストール手順

1. 依存関係のインストール

   npm install @pinkpixel/mcpollinations
   

2. モジュールのインポート

   import { generateImageUrl, generateImage, respondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';
   

3. サーバーの起動
   • ターミナルで以下のコマンドを実行します。

     npm start
     

   • デフォルトのポートは 8080 です。
   • アクセスアドレスは http://localhost:8080 です。

環境要件

• オペレーティングシステム：Linux、macOS、Windows をサポートしています。
• Node.js バージョン：Node.js 14.19.1 またはそれ以上のバージョンが必要です。

📚 ドキュメント

設定ガイド

画像生成オプション

const options = {
  // モデル選択（デフォルトは 'flux'）
  model: "flux",

  // 画像サイズ
  width: 1024,
  height: 1024,

  // 生成パラメータ
  seed: 12345,  // 再現性を保証するための具体的なシード値（デフォルトはランダム）
  enhance: true,  // LLM を使用してプロンプトを強化する（デフォルトで有効）
  safe: false,  // コンテンツフィルタリングのオン/オフ（デフォルトはオフ）

  // ファイル保存オプション
  saveToFile: true,  // ファイル保存をスキップするには false に設定
  outputPath: "/path/to/save/directory",  // カスタム保存パス
  fileName: "my_custom_name",  // 拡張子を含まない
  format: "png"  // サポートされる形式: png、jpeg、jpg、webp
};

出力パスの説明

• デフォルトの保存場所：サーバーが実行されているディレクトリの作業ディレクトリです。
• Claude Desktop が自動起動する場合：Claude のアプリケーションデータフォルダ（通常はユーザーのホームディレクトリ内）に保存されます。

重複防止メカニズム

生成される画像の一意性を確保し、上書きを防ぐために、MCP サーバーは以下の措置を講じています。

1. デフォルトのファイル名：
   • プロンプトのクリーン化されたバージョン（先頭 20 文字）
   • タイムスタンプ
   • ランダムなサフィックス
2. カスタムファイル名の保護：
   • 指定されたファイルが既に存在する場合、自動的に数字のサフィックスが追加されます。
   • 例：sunset.png、sunset_1.png など。

Base64 データのアクセス

ファイルに保存するかどうかに関係なく、Base64 エンコードされた画像データが返され、以下の用途に便利です。

• ウェブページへの埋め込み (<img>)
• 他のサービスや API への転送
• メモリ内での処理
• データ URI をサポートするアプリケーションでの表示

開発者ガイド

MCPollinations をプロジェクトに統合するには、以下の手順を実行します。

1. 依存関係のインストール

   npm install @pinkpixel/mcpollinations
   

2. コード例

   import { generateImageUrl, generateImage, respondText, respondAudio, listTextModels, listImageModels, listAudioVoices } from '@pinkpixel/mcpollinations';
   
   // 使用例：
   const imageUrl = generateImageUrl('sunset over mountains', {
     width: 800,
     height: 600
   });
   

🔧 トラブルシューティング

一般的な問題

• ポートの競合：起動時に 8080 ポートが使用中というエラーが表示された場合は、別のポートを試してください。
• モジュールが見つからない：MCPollinations パッケージが正しくインストールされていることを確認してください。

サポートへの連絡

ヘルプが必要な場合は、GitHub リポジトリ を訪問してドキュメントを確認するか、問題を提出してください。