Processing MCP Server

正在处理MCP服务器

🎨 用AI创造视觉艺术和游戏 -MCP（模型上下文协议）服务器，使AI助手能够通过自然语言命令直接创建和运行处理草图。

⭐ 如果你觉得这个有用，给我们一颗星！

🎥 演示视频

在这里观看演示视频-看看它的实际效果！

🚀 快速设置

1. 克隆此存储库：

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

1. 安装依赖项：

   uv pip install fastmcp
   # or
   pip install fastmcp

1. 配置Claude桌面 （见下面的配置部分）

1. 重启克劳德，开始创作！

特性

• 🚀 从AI对话中创建和运行处理草图
• 💾 自动保存带有时间戳的草图
• ⚙️ 可配置处理可执行路径和保存位置
• 🤖 AI助手的简单工具界面
• 🎮 包括6个现成的演示（粒子、3D艺术、游戏等！）

安装

先决条件

• Python 3.8+
• 处理 安装在您的系统上
• uv 包管理器（或使用pip）
• 克劳德桌面应用程序

步骤1：克隆存储库

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

步骤2：安装依赖项

通过紫外线安装

uv pip install fastmcp

通过pip安装

pip install fastmcp

步骤3：配置Claude桌面

请参阅下面的配置部分，将服务器添加到您的Claude Desktop配置中。

配置

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

1.环境变量

在运行服务器之前设置这些环境变量：

• PROCESSING_PATH：处理可执行文件的路径
• PROCESSING_SAVE_LOCATION：保存草图的目录

2.克劳德桌面配置

将此添加到您的Claude Desktop配置文件中：

视窗 (%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以使更改生效。

使用示例

配置后，您可以要求您的AI助手：

🎯 简单动画

• “创建一个绘制弹跳球的加工草图”
• “制作彩色螺旋动画”
• “绘制一个显示当前时间的时钟”

✨ 粒子效果

• “创建一个跟随鼠标的粒子系统”
• “让烟花在我点击时爆炸”
• “生成星场模拟”

🎮 游戏

• “构建一个蛇游戏”
• “创建Pong克隆”
• “制作一个简单的迷宫游戏”

🎨 衍生艺术

• “用流动的波浪创造一件具有生成性的艺术作品”
• “制作3D旋转几何形状”
• “生成Matrix数字雨效果”

包括示例

看看 /examples 用于准备运行演示的文件夹：

1. bouncing_ball.pde -带有轨迹效果的经典动画
2. 颗粒系统.pde -跟随鼠标的交互式粒子
3. 三维几何零件设计 -彩虹色的迷人3D形状
4. matrix_rain.pde -标志性的Matrix数字雨效
5. wave_art.pde -美丽的动画波浪图案
6. 蛇名.pde -完全可玩的蛇游戏

AI将使用 run_processing_java_cli 创建和启动草图的工具。

可用工具

run_processing_java_cli

创建并运行加工草图。

参数：

• java_code （必填）：加工草图代码
• processing_path （可选）：覆盖默认的Processing可执行路径
• save_location （可选）：覆盖默认保存位置

get_processing_config

返回当前服务器配置。

默认路径

如果没有提供配置，服务器将使用以下默认值：

• 处理路径: processing （假设处理在您的系统PATH中）
• 保存位置: ~/Documents/Processing/sketches

故障排除

服务器未在Claude中显示

请确保在更新配置文件后重新启动Claude Desktop。

未找到处理

如果您收到“未找到处理可执行文件”错误：

1. 确保已安装Processing
2. 检查配置中的路径是否正确
3. 在Windows上，使用双反斜杠(\\)在路上
4. 在macOS上，路径应指向.app捆绑包中的可执行文件

权限错误

确保保存位置目录存在并且用户可以写入。

贡献

欢迎投稿！请随时提交拉取请求。

许可证

MIT许可证-有关详细信息，请参阅许可证文件