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文件。