Face Generator MCP Server

Face Generator MCP Server：人間の顔を簡単に生成

機能

このプロジェクトは、https://thispersondoesnotexist.com を使用して人間の顔画像を生成する Model Context Protocol（MCP）サーバーを提供します。Cline などのほかのアプリケーションから、必要なときにリアルな顔を生成できるツールだと考えてください。

このガイドは初心者向けに作られているため、すべてを順を追って説明します。以下の内容を扱います。

1. 前提条件： 始める前に必要なもの。
2. インストールとセットアップ： すべてを準備して実行できるようにします。
3. サーバーの実行： サーバーを起動します。
4. Cline との統合： このサーバーを Cline の VS Code 拡張機能に接続します。
5. トラブルシューティング： よくある問題と解決方法。
6. ツールのパラメーター： generate_face ツールで使用できるパラメーターの一覧。

1. 前提条件

始める前に、いくつか必要なものがあります。

• Node.js と npm： Node.js は、ウェブブラウザーの外部で JavaScript コードを実行できる JavaScript ランタイムです。npm（Node Package Manager）は Node.js に含まれており、パッケージ（コードライブラリ）のインストールに使用されます。
  • Node.js をダウンロード。LTS（Long Term Support）バージョンを選択してください。 これが最も安定したバージョンです。お使いのオペレーティングシステムに対応したインストール手順に従ってください。インストールに npm が含まれていることを確認してください（通常はデフォルトで含まれています）。
  • インストールの確認： Node.js をインストールしたら、新しいターミナル（Windows ではコマンドプロンプト、macOS/Linux ではターミナル）を開き、次のように入力します。

    node -v
    npm -v
    

    Node.js と npm の両方のバージョン番号が表示されます。エラーが表示される場合は、Node.js が正しくインストールされていないか、システムの PATH に含まれていない可能性があります。（下記のトラブルシューティングを参照してください）。

2. インストールとセットアップ

プロジェクトのコードを取得してセットアップしましょう。

1. リポジトリをクローンする：

   • Git を使用する（コマンドライン）：
     1. ターミナル（コマンドプロンプトまたはターミナル）を開きます。
     2. プロジェクトを保存するディレクトリに移動します。たとえば、デスクトップに保存するには、次のようにします。

        cd Desktop
        

     3. リポジトリをクローンします。

        git clone https://github.com/Moe/mcp-face-generator
        

     4. プロジェクトディレクトリに移動します。

        cd mcp-face-generator
        

   • GitHub Desktop を使用する：
     1. GitHub Desktop を開きます。
     2. 「ファイル」→「リポジトリをクローン...」をクリックします。
     3. 「URL」タブにリポジトリの URL を貼り付けます。
     4. ローカルパス（コンピューター上でプロジェクトを保存する場所）を選択します。
     5. 「クローン」をクリックします。

2. 依存関係をインストールする： これにより、プロジェクトに必要なライブラリがすべてダウンロードされます。ターミナルでプロジェクトディレクトリ内に移動し、次を実行します。

   npm install
   

   数分かかる場合があります。

3. プロジェクトをビルドする： これにより、コードが実行可能な形式にコンパイルされます。

   npm run build
   

3. サーバーの実行

サーバーは主に次の2つの方法で実行できます。

• スタンドアロンモード： サーバーを直接実行し、ターミナルにメッセージを出力します。
• 開発／デバッグモード： MCP Inspector とともにサーバーを実行します。出力された URL をブラウザーで開いて、いろいろ試すことができます。

3.1 スタンドアロンモード

サーバーをスタンドアロンモードで実行するには、ターミナルで（プロジェクトディレクトリから）次のコマンドを使用します。

npm run start

ターミナルにサーバーが実行中であることを示すメッセージが表示されます。MCP クライアントからの接続を待ち受けます。サーバーは停止するまで実行され続けます（通常は Ctrl+C で停止します）。

3.2 開発／デバッグモード（Inspector を使用）

このモードはデバッグに便利です。

1. デバッグモードでサーバーを起動します：

   npm run dev
   

   サーバーが起動し、🔍 MCP Inspector is up and running at http://localhost:5173 🚀 のようなメッセージが出力されます。この URL を使って、ブラウザーで MCP Inspector を開きます。

4. Cline との連携

Cline は、言語サポートを提供するために MCP サーバーを使用する VS Code 拡張機能です。顔生成サーバーを Cline に接続する方法は次のとおりです。

1. Cline をインストールします： まだインストールしていない場合は、VS Code に「Cline」拡張機能をインストールします。

2. Cline の設定を開きます：

   • VS Code の設定を開きます（File -> Preferences -> Settings、または Ctrl+,）。
   • 「Cline MCP Settings」を検索します。
   • 「Edit in settings.json」をクリックします。cline_mcp_settings.json ファイルが開きます。

3. サーバーの設定を追加します： cline_mcp_settings.json ファイルの servers 配列にエントリを追加します。例を示します：

   {
     "mcpServers": {
       "face-generator": {
         "command": "node",
         "args": [
           "C:/PATH_TO/mcp-face-generator/build/index.js"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

   • "C:/PATH_TO/mcp-face-generator/build/index.js" を、プロジェクトディレクトリにある index.js ファイルの実際のパスに置き換えます。Windows では、パスにスラッシュ（/）または二重のバックスラッシュ（\\）を使用してください。

4. 接続をテストします：

   • Cline はサーバーに自動的に接続するはずです。「MCP Servers」パネルにサーバーが表示されます（Cline 拡張機能の上部に複数のボタンがあります）。
   • Cline に顔を生成するよう依頼すると、MCP サーバーに言及し、対応するツールを使おうとするはずです。

5. トラブルシューティング

• node -v または npm -v でエラーが発生する場合：
  • Node.js が正しくインストールされていることを確認します。再インストールしてみてください。
  • Node.js のインストールディレクトリが、システムの PATH 環境変数に含まれていることを確認します。Windows では、システムのプロパティから環境変数を編集できます（スタートメニューで「environment variables」を検索してください）。
• npm install が失敗する場合：
  • インターネットに接続されていることを確認します。
  • node_modules フォルダーを削除してから、もう一度 npm install を実行してみてください。
  • プロキシを使用している場合は、プロキシを使用するように npm を設定する必要がある場合があります。「npm proxy settings」をオンラインで検索してください。
• Cline がサーバーに接続できない場合：
  • cline_mcp_settings.json の設定を再確認します。index.js ファイルの正しいパスを指定する必要があります。
  • サーバーが実行中であることを確認します（npm run start を使用して確認してください）。
  • VS Code を再起動します。

6. ツールのパラメーター

generate_face ツールは、次のパラメーターを受け取ります：

• outputDir：画像の保存先ディレクトリ（必須）
• fileName：ファイル名（省略可能。デフォルトはタイムスタンプ）
• count：生成する画像の数（デフォルト：1）
• width：画像の幅（ピクセル単位。デフォルト：256）
• height：画像の高さ（ピクセル単位。デフォルト：256）
• shape：画像の形状（square|circle|rounded、デフォルト：square）
• borderRadius：rounded 形状の角の丸み（デフォルト：32）
• returnImageContent：ファイルパスの代わりに、画像を base64 エンコードされたコンテンツとして返します（デフォルト：false）

例

{
  "outputDir": "./output",
  "count": 3,
  "width": 512,
  "height": 512,
  "shape": "circle",
  "returnImageContent": true
}

ライセンス

MIT