金大哥 - processing-mcp-server MCP 详情

article

README

🚀 处理MCP服务器

🎨 借助人工智能创作视觉艺术和游戏 - 这是一个MCP（模型上下文协议）服务器，它能让人工智能助手通过自然语言命令直接创建并运行Processing草图。

⭐ 如果您觉得这个项目有用，请给我们点个星！

🚀 快速开始

快速设置步骤

克隆此仓库：

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

安装依赖项：

uv pip install fastmcp
# 或者
pip install fastmcp

配置Claude桌面应用（请参阅下面的配置部分）
重启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文件夹中的可直接运行的演示示例：

bouncing_ball.pde - 带有拖尾效果的经典动画
particle_system.pde - 跟随鼠标的交互式粒子效果
3d_geometric_art.pde - 带有彩虹颜色的迷人3D形状
matrix_rain.pde - 标志性的《黑客帝国》数字雨效果
wave_art.pde - 美丽的动画波浪图案
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可执行文件”的错误：

确保已安装Processing
检查您配置中的路径是否正确
在Windows系统中，路径中使用双反斜杠 (\\)
在macOS系统中，路径应指向.app包内的可执行文件

权限错误

请确保保存位置的目录存在，并且您的用户具有写入权限。

🤝 贡献

欢迎贡献代码！请随时提交拉取请求。

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

🎥 演示视频

点击此处观看演示视频 - 查看实际运行效果！

processing-mcp-server