Processing MCP Server

Processing MCP 服务

🎨 使用 AI 创作视觉艺术和游戏 - 一个 MCP（模型上下文协议）服务，可让 AI 助手通过自然语言命令直接创建并运行 Processing 草图。

⭐ 如果你觉得这很有用，请给我们点个星！

🎥 演示视频

点击此处观看演示视频 - 看看它如何运行！

🚀 快速设置

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 配置中。

配置

可以通过两种方式配置服务：

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 几何体”
• “生成《黑客帝国》的数字雨效果”

内置示例

查看 /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 软件包内的可执行文件

权限错误

请确保保存位置的目录已存在，且你的用户拥有写入权限。

参与贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT License——详情请参阅 LICENSE 文件