Processing MCP Server

🚀 Processing MCP Server

🎨 AIによるビジュアルアートとゲームの作成 - AIアシスタントが自然言語コマンドで直接Processingスケッチを作成し実行できるMCP（Model Context Protocol）サーバーです。

⭐ このプロジェクトが役に立った場合は、スターをつけてください！

🚀 クイックスタート

🎥 デモビデオ

ここでデモビデオを見る - 実際の動作を確認！

セットアップ手順

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

   git clone https://github.com/twelve2five/processing-mcp-server.git
   cd processing-mcp-server
   

2. 依存関係をインストールする：

   uv pip install fastmcp
   # または
   pip install fastmcp
   

3. Claude Desktopを設定する（下記の「設定」セクションを参照）
4. Claudeを再起動し、作成を開始する！

✨ 主な機能

• 🚀 AI会話からProcessingスケッチを作成し実行する
• 💾 タイムスタンプ付きでスケッチを自動保存する
• ⚙️ Processing実行ファイルのパスと保存場所を設定可能
• 🤖 AIアシスタント用のシンプルなツールインターフェイス
• 🎮 実行可能な6つのデモ（パーティクル、3Dアート、ゲームなど）が含まれている！

📦 インストール

前提条件

• Python 3.8以上
• Processingがシステムにインストールされている
• uvパッケージマネージャー（またはpipを使用）
• Claude Desktopアプリ

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

git clone https://github.com/twelve2five/processing-mcp-server.git
cd processing-mcp-server

手順2：依存関係をインストールする

uvを使用してインストールする

uv pip install fastmcp

pipを使用してインストールする

pip install fastmcp

手順3：Claude Desktopを設定する

下記の「設定」セクションを参照して、サーバーをClaude Desktopの設定に追加してください。

設定

サーバーは2つの方法で設定できます：

1. 環境変数

サーバーを実行する前に、これらの環境変数を設定してください：

• PROCESSING_PATH：Processing実行ファイルのパス
• PROCESSING_SAVE_LOCATION：スケッチが保存されるディレクトリ

2. Claude Desktopの設定

Claude Desktopの設定ファイルにこれを追加してください：

Windows (%APPDATA%\Claude\claude_desktop_config.json)：

{
  "mcpServers": {
    "processing": {
      "command": "uv",
      "args": [
        "run",
        "C:\\path\\to\\processing-mcp-server\\processing_mcp_server.py"
      ],
      "env": {
        "PROCESSING_PATH": "C:\\Program Files\\Processing\\Processing.exe",
        "PROCESSING_SAVE_LOCATION": "C:\\Users\\YourUsername\\Documents\\Processing\\sketches"
      }
    }
  }
}

macOS (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "processing": {
      "command": "uv",
      "args": [
        "run",
        "/path/to/processing-mcp-server/processing_mcp_server.py"
      ],
      "env": {
        "PROCESSING_PATH": "/Applications/Processing.app/Contents/MacOS/Processing",
        "PROCESSING_SAVE_LOCATION": "~/Documents/Processing/sketches"
      }
    }
  }
}

Linux (~/.config/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "processing": {
      "command": "uv",
      "args": [
        "run",
        "/path/to/processing-mcp-server/processing_mcp_server.py"
      ],
      "env": {
        "PROCESSING_PATH": "/usr/bin/processing",
        "PROCESSING_SAVE_LOCATION": "~/Documents/Processing/sketches"
      }
    }
  }
}

注意： /path/to/processing-mcp-server/を、実際にリポジトリをクローンしたパスに置き換えてください。

3. Claude Desktopを再起動する

設定ファイルを更新した後、変更を反映するためにClaude Desktopを再起動してください。

💻 使用例

設定が完了したら、AIアシスタントに以下のようなことを依頼できます：

🎯 シンプルなアニメーション

• "バウンドするボールを描くProcessingスケッチを作成して"
• "カラフルなスパイラルアニメーションを作成して"
• "現在の時刻を表示する時計を描いて"

✨ パーティクルエフェクト

• "マウスを追跡するパーティクルシステムを作成して"
• "クリックすると爆発する花火を作成して"
• "星空シミュレーションを生成して"

🎮 ゲーム

• "スネークゲームを作成して"
• "ポンゲームのクローンを作成して"
• "シンプルな迷路ゲームを作成して"

🎨 ジェネラティブアート

• "流れる波を持つジェネラティブアート作品を作成して"
• "3D回転する幾何学的形状を作成して"
• "マトリックスのデジタル雨エフェクトを生成して"

含まれるサンプル

実行可能なデモは/examplesフォルダを確認してください：

1. bouncing_ball.pde - トレイルエフェクト付きの古典的なアニメーション
2. particle_system.pde - マウスを追跡するインタラクティブなパーティクル
3. 3d_geometric_art.pde - 虹色の魅惑的な3D形状
4. matrix_rain.pde - 象徴的なマトリックスのデジタル雨エフェクト
5. wave_art.pde - 美しいアニメーション波パターン
6. snake_game.pde - 完全にプレイ可能なスネークゲーム

AIはrun_processing_java_cliツールを使用して、スケッチを作成し起動します。

利用可能なツール

run_processing_java_cli

Processingスケッチを作成し実行します。

パラメータ：

• java_code（必須）：Processingスケッチのコード
• processing_path（オプション）：デフォルトのProcessing実行ファイルのパスを上書きする
• save_location（オプション）：デフォルトの保存場所を上書きする

get_processing_config

現在のサーバー設定を返します。

デフォルトのパス

設定が提供されない場合、サーバーはこれらのデフォルト値を使用します：

• Processingパス：processing（ProcessingがシステムのPATHに含まれていることを想定）
• 保存場所：~/Documents/Processing/sketches

トラブルシューティング

Claudeにサーバーが表示されない

設定ファイルを更新した後、Claude Desktopを再起動してください。

Processingが見つからない

"Processing実行ファイルが見つかりません"というエラーが表示された場合：

1. Processingがインストールされていることを確認する
2. 設定内のパスが正しいことを確認する
3. Windowsでは、パスにダブルバックスラッシュ (\\) を使用する
4. macOSでは、パスは.appバンドル内の実行ファイルを指す必要がある

権限エラー

保存場所のディレクトリが存在し、ユーザーが書き込み可能であることを確認してください。

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。