AI生成视觉艺术工具

一个基于Processing的MCP服务器,允许通过自然语言命令创建和运行视觉艺术及游戏草图。

  • by twelve2five
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 twelve2five/processing-mcp-server

使用说明

正在处理MCP服务器

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

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

🎥 演示视频

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

🚀 快速设置

  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桌面 (见下面的配置部分)

  4. 重启克劳德,开始创作!

特性

  • 🚀 从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许可证-有关详细信息,请参阅许可证文件