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
   # or
   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 のスケッチを作成して」
• 「カラフルな渦巻きアニメーションを作って」
• 「現在時刻を表示する時計を描いて」

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

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

🎮 ゲーム

• 「スネークゲームを作って」
• 「Pong のクローンを作成して」
• 「シンプルな迷路ゲームを作って」

🎨 ジェネレーティブアート

• 「流れる波を使ったジェネレーティブアート作品を作成して」
• 「回転する 3D の幾何学図形を作って」
• 「Matrix のデジタルレイン効果を生成して」

含まれているサンプル

すぐに実行できるデモは /examples フォルダーをご覧ください。

1. bouncing_ball.pde — 軌跡効果を使った定番のアニメーション
2. particle_system.pde — マウスに追従するインタラクティブなパーティクル
3. 3d_geometric_art.pde — 虹色の魅惑的な 3D 図形
4. matrix_rain.pde — おなじみの Matrix デジタルレイン効果
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 Path：processing（Processing がシステムの PATH にあることを前提とします）
• Save Location：~/Documents/Processing/sketches

トラブルシューティング

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

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

Processing が見つからない

「Processing executable not found」エラーが表示される場合：

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

権限エラー

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください