Processing MCP Server

🚀 Processing MCP服務器

🎨 利用人工智能創作視覺藝術與遊戲 - 這是一個MCP（模型上下文協議）服務器，它允許人工智能助手通過自然語言命令直接創建並運行Processing草圖。

⭐ 如果您覺得這個項目有用，請給我們點個星！

🚀 快速開始

視頻演示

點擊觀看演示視頻 - 見證實際效果！

快速設置

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桌面應用（請參閱下面的配置部分）

4. 重啟Claude並開始創作！

✨ 主要特性

• 🚀 從人工智能對話中創建並運行Processing草圖
• 💾 自動保存帶有時間戳的草圖
• ⚙️ 可配置Processing可執行文件路徑和保存位置
• 🤖 為人工智能助手提供簡單的工具界面
• 🎮 包含6個可直接運行的演示（粒子效果、3D藝術、遊戲等！）

📦 安裝指南

前提條件

• Python 3.8+
• 系統已安裝Processing
• uv包管理器（或使用pip）
• Claude桌面應用程序

步驟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桌面應用

請參閱下面的配置部分，將服務器添加到您的Claude桌面應用配置中。

🔧 配置說明

服務器可以通過兩種方式進行配置：

1. 環境變量

在運行服務器之前設置以下環境變量：

• PROCESSING_PATH：Processing可執行文件的路徑
• PROCESSING_SAVE_LOCATION：草圖保存的目錄

2. Claude桌面應用配置

將以下內容添加到您的Claude桌面應用配置文件中： 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桌面應用

更新配置文件後，重啟Claude桌面應用以使更改生效。

💻 使用示例

配置完成後，您可以要求您的人工智能助手執行以下操作：

🎯 簡單動畫

• "創建一個繪製彈跳球的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 - 完全可玩的貪吃蛇遊戲

人工智能將使用run_processing_java_cli工具來創建和啟動您的草圖。

📚 詳細文檔

可用工具

run_processing_java_cli

創建並運行一個Processing草圖。 參數：

• java_code（必需）：Processing草圖代碼
• processing_path（可選）：覆蓋默認的Processing可執行文件路徑
• save_location（可選）：覆蓋默認的保存位置

get_processing_config

返回當前服務器配置。

默認路徑

如果未提供配置，服務器將使用以下默認值：

• Processing路徑：processing（假設Processing在系統路徑中）
• 保存位置：~/Documents/Processing/sketches

🔧 故障排除

Claude中未顯示服務器

更新配置文件後，請確保重啟Claude桌面應用。

未找到Processing

如果您遇到“未找到Processing可執行文件”錯誤：

1. 確保已安裝Processing
2. 檢查配置中的路徑是否正確
3. 在Windows上，路徑中使用雙反斜槓 (\\)
4. 在macOS上，路徑應指向.app包內的可執行文件

權限錯誤

請確保保存位置目錄存在，並且您的用戶具有寫入權限。

貢獻說明

歡迎貢獻代碼！請隨時提交拉取請求。

📄 許可證

本項目採用MIT許可證 - 詳情請參閱LICENSE文件。