🚀 处理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文件。