aesthetic-computer

@aesthetic.computer/mcp

适用于 aesthetic.computer 的 MCP（Model Context Protocol）服务，让 AI 助手能够创作并发布创意编程作品。

这是什么？

这个 MCP 服务让 Claude、ChatGPT 等 AI 助手及其他兼容 MCP 的工具能够：

• ✨ 向 aesthetic.computer 发布 JavaScript 作品
• 🎨 创作并分享 KidLisp 艺术作品（一种基于 Lisp 的创意编程语言）
• 🎵 使用易于读出的短代码创作时钟旋律
• 📚 以编程方式访问 API 文档
• 🚀 获取入门模板和参考资料
• 🔄 内容去重——相同代码会返回相同 URL
• 🌐 匿名发布——无需账户

安装

全局安装 NPM

npm install -g @aesthetic.computer/mcp

NPX（无需安装 — 推荐）

npx @aesthetic.computer/mcp

无需安装！MCP 配置中的 -y 标志会自动下载并运行最新版本。

配置

Claude Desktop

将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "aesthetic-computer": {
      "command": "npx",
      "args": ["-y", "@aesthetic.computer/mcp"],
      "env": {
        "AC_TOKEN": "your-auth0-bearer-token-here"
      }
    }
  }
}

Claude Code（VS Code 扩展）

将配置添加到 .vscode/mcp.json 或 ~/.claude/mcp.json：

{
  "mcpServers": {
    "aesthetic-computer": {
      "command": "npx",
      "args": ["-y", "@aesthetic.computer/mcp"],
      "env": {
        "AC_TOKEN": "your-auth0-bearer-token-here"
      }
    }
  }
}

Cursor

将配置添加到 Cursor MCP 设置中：

{
  "mcpServers": {
    "aesthetic-computer": {
      "command": "npx",
      "args": ["-y", "@aesthetic.computer/mcp"]
    }
  }
}

身份验证（可选）

AC_TOKEN 环境变量为可选项。如果未提供：

• 所有发布操作都会以匿名方式进行（访客模式）
• 作品仍可公开访问
• 若要将作品关联到你的账户，请提供来自 aesthetic.computer 的 Bearer 令牌

可用工具

publish_piece

向 aesthetic.computer 发布 JavaScript 作品。

输入：

{
  "source": "export function boot($) { ... }\nexport function paint($) { ... }",
  "name": "my-piece"
}

输出：

{
  "code": "drift",
  "url": "https://aesthetic.computer/drift",
  "cached": false
}

publish_kidlisp

发布 KidLisp 代码。

输入：

{
  "source": "(wipe blue)\n(ink yellow)\n(circle (/ w 2) (/ h 2) 100)"
}

输出：

{
  "code": "xyz789",
  "url": "https://aesthetic.computer/xyz789",
  "cached": false
}

publish_clock

发布时钟旋律。

输入：

{
  "source": "c4 e4 g4 c5 g4 e4 c4"
}

输出：

{
  "code": "bako",
  "url": "https://aesthetic.computer/clock~bako",
  "cached": false
}

get_api_info

获取完整的 API 文档。

preview_kidlisp

验证 KidLisp 源代码，但不发布。返回语法错误、警告，以及源代码中函数和交互行为或动画行为的摘要。

可用资源

aesthetic-computer://piece-template

返回一个 aesthetic.computer 新作品的入门模板，包含所有生命周期函数（boot、paint、sim、act）。

aesthetic-computer://kidlisp-reference

KidLisp 语法和常用函数的快速参考指南。

aesthetic-computer://piece-examples

精选热门已发布作品的示例。

可用提示词

create-piece

用于创作 aesthetic.computer 作品的引导式提示词。

参数：

• name（必填）：作品名称
• description（必填）：作品应实现的功能

create-kidlisp

用于创作并发布 KidLisp 作品的引导式提示词。

参数：

• description（必填）：作品应实现的功能

为什么使用它？

• 🎨 轻松创意编程：让 AI 助手为你编写 aesthetic.computer 作品
• ⚡ 即时发布：几秒钟内即可将想法变成在线 URL
• 🔗 可分享的 URL：每个作品都有简洁、可分享的链接
• 🆓 无需账户：开箱即用，支持匿名发布
• ♻️ 智能去重：相同代码会返回相同 URL
• 🌍 开放平台：所有作品均可公开访问

对话示例

配置完成后，你可以向 AI 助手提出以下请求：

JavaScript 作品

“创建一个绘制弹跳球的作品”

“制作一个交互式绘画画布，让我可以用鼠标绘画”

“构建一个能响应声音的粒子系统”

KidLisp 艺术作品

“制作一个 KidLisp 作品，包含蓝色背景上的黄色圆形”

“使用 KidLisp 和随机形状创作生成艺术”

时钟旋律

“使用 C 大调音阶发布一段时钟旋律”

“为时钟创作一段五声音阶旋律”

学习与模板

“给我看看作品模板”

“KidLisp 中有哪些函数可用？”

AI 将使用 MCP 工具自动创建并发布作品，并返回可立即访问的实时 URL！

开发

# Clone the repo
git clone [email protected]:aesthetic.computer/core
cd aesthetic-computer/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Test locally
node dist/index.js

链接

• 🌐 aesthetic.computer
• 📖 API 文档
• 🎨 KidLisp 文档
• 📝 作品编写指南
• 🔧 MCP 规范

许可证

MIT

作者

Jeffrey Alan Scudder