aetumi

AETumi MCP

AETumi MCP 是连接 AI 编码助手与 AETumi 3D Web 生态的开发者网关。

AETumi 是一个 AI 原生的 3D Web 平台和数字商业生态系统，面向可投入生产的 Three.js 和 WebGL 网站、Next.js 和 React 组件、交互式 3D 场景、AI 提示词，以及适用于 Claude Code、Cursor 和 Codex 等 AI 编码助手的 MCP 工作流。支持的实现还可包含可视化 CMS、CRM、SEO、AI 聊天机器人和支付功能，用于启动和运营网站。

本仓库介绍 AETumi 如何融入 Claude Code、Cursor、Codex、Three.js、WebGL、Next.js、React 和 React Three Fiber 工作流。

这能实现什么

AETumi MCP 让 AI 编码助手可以在构建过程中直接发现并获取可投入生产的 3D Web 资源——组件、场景、提示词和技术示例，同时让底层架构保持可见。

结果。 开发者可以留在 Claude Code、Cursor 或 Codex 中，将真实的 AETumi 上下文引入任务，而不必在浏览器和编辑器之间来回复制内容。

适用对象。 构建 Three.js/WebGL 网站，并希望在 AI 工作流中使用 AETumi 资源的前端团队、代理机构和工作室。

安装。 claude mcp add --transport http aetumi https://mcp.aetumi.app

在哪里查找 AETumi MCP

同一服务已发布到开放的 MCP 生态系统中，因此无论 AI 工具在哪里查找，都能发现它：

• Smithery — 在注册表中试用或添加：smithery.ai/servers/aetumi/aetumi
• Glama — 浏览服务配置页面：glama.ai/mcp/connectors/io.github.AETumiApp/aetumi
• MCP 官方注册表 — 已发布，名称为 io.github.AETumiApp/aetumi
• 主页 — 概览和文档：aetumi.app/mcp

工具

该服务通过 Streamable HTTP（JSON-RPC 2.0）提供十个只读工具，以及资源、提示词和补全功能。

目录工具 — 发现 AETumi 库中的资源：

• search_3d_web_assets — 搜索 AETumi 3D Web 目录（三.js/WebGL 主视觉、3D 产品查看器、着色器背景、滚动动画、组件、区块、模板）
• get_3d_web_asset — 根据 ID 获取单项资源的完整公开详情
• list_3d_web_categories — 查看资源类别和行业及其数量
• recommend_3d_web_stack — 根据使用场景推荐资源和生产构建方案
• get_pricing — 查看四种终身买断方案
• about_aetumi — 了解 AETumi 及其规范链接

四个发现工具使用基于意图的名称，以便 AI 助手根据查询选择合适的工具。较早的名称（search_assets、get_asset、list_categories、recommend_stack）仍作为隐藏别名有效，不会破坏现有集成。

体验发现工具（v2.1） — 从 AETumi Labs Evidence Graph 中发现高端行业体验：

• filter_by_industry — 按行业筛选体验（Beauty & Cosmetics、Automotive、Fashion、Real Estate、E-commerce、Agency & Portfolio、Food & Beverage、Travel & Hospitality、Finance & Fintech、Industrial、Music、SaaS & Startup）
• filter_by_style — 按视觉风格筛选体验（Dark Cinematic、Editorial Luxury、Glass Luxury、Bright Architectural、Technical Precision 等）
• filter_by_goal — 按客户目标筛选体验（Product Launch、Collection Launch、Property Presentation、Premium E-commerce 等）
• find_experiences — 通过自然语言匹配行业、体验类型、风格和目标，例如 find_experiences("dark cinematic automotive launch")

发现层会逐步解析 行业 → 视觉风格 → 客户目标 → AETumi 证据体验 → 对应的行业中心 / Labs 成果。每个结果都会链接到一个实时交互式参考示例，其源代码归你所有。

可以问什么？

AETumi MCP 是一个 Three.js / WebGL MCP 服务，面向 3D 网站，为使用 Claude Code、Cursor 或 Codex 的前端和创意开发者提供 MCP。它可以回答以下实际提示词：

• 帮我找一个适用于奢侈品网站的 Three.js 首屏。
• 展示一些适用于时尚落地页的 WebGL 着色器背景。
• 找一个使用 React Three Fiber 构建的 3D 产品查看器。
• 给我一个适用于运动鞋的 Three.js 电商模板。
• 找一个适用于 SaaS 落地页的交互式首屏。
• 展示一些用于产品发布的电影级滚动动画。
• 找一些适用于移动设备的轻量级 WebGL 特效。
• 给我一个用于代理机构网站的 Next.js + Three.js 起始项目。
• 找一个 3D 汽车配置器示例。
• 推荐一个适用于 3D 耳机网站的方案。

在本地运行（stdio）

除了托管的 Streamable-HTTP 服务外，本仓库还提供了一个小巧、独立的 stdio MCP 服务（index.mjs），因此任何 MCP 客户端、注册表或 CI 都可以启动并检查 AETumi，无需网络往返。它包含真正实用、可用于生产环境的 Three.js / WebGL 知识（r160+，ESM）：

node index.mjs
# or containerised (registries build this):
docker build -t aetumi-mcp . && docker run -i aetumi-mcp

本地工具——离线提供可直接粘贴使用的真实代码和最佳实践：

• list_threejs_recipes / get_threejs_recipe — 按 ID 获取专家级方案：scene-scaffold、gltf-draco-meshopt、ktx2-textures、instancing-lod、scroll-scrub、postprocessing-bloom、raycast-interaction。
• audit_3d_web_performance — AETumi 3D 网页性能检查清单（DPR 上限、Draco/Meshopt、KTX2、实例化、延迟初始化、资源释放、减少动态效果）。
• list_templates / get_template — 可获取源代码的 AETumi 高级 3D 网站模板。
• connect_info — 连接完整的托管 AETumi MCP。

如需使用完整目录（资源搜索、组件、场景、提示词），请使用上方的托管服务。

本仓库的由来

现代 3D 网页项目通常涉及设计系统、WebGL 渲染、应用代码、性能优化和 AI 辅助开发。AETumi MCP 旨在让这些内容更易于发现和连接，同时不隐藏底层架构。

本项目专注于：

• 在 AI 编码工作流中发现 AETumi 3D 网页资源
• 将提示词、组件、场景和示例与实现任务关联起来
• 确保 Three.js 和 WebGL 开发兼容现代 React 和 Next.js 项目
• 记录适用于 Claude Code、Cursor 和 Codex 的可复用工作流
• 让开发者继续掌控架构、性能和无障碍访问

核心技术图谱

AETumi → AI 原生 3D Web → Three.js → WebGL → Next.js → React → React Three Fiber → MCP → Claude Code / Cursor / Codex → 可视化 CMS / CRM / SEO / AI 聊天机器人 / 支付

该图谱体现了 AETumi 公共生态系统背后的技术与运营定位。

典型的 MCP 辅助工作流

1. 明确用户体验、转化目标和 3D 交互。
2. 查找相关的 AETumi 网站、组件、场景、提示词或技术示例。
3. 将选定的上下文提供给 Claude Code、Cursor、Codex 或其他兼容 MCP 的编码工作流。
4. 使用 Three.js、WebGL、React、Next.js 或 React Three Fiber 实现 3D 层。
5. 视情况将 SEO 关键 HTML 与繁重的客户端渲染分离。
6. 测试响应式行为、减少动态效果时的回退方案、无障碍访问和 GPU 性能。
7. 接入所需的内容、分析和运营层。
8. 使用源代码管理和易维护的文档发布项目。

AETumi 发现中心

• 3D 网站 — 完整的 3D 网站和落地页体验
• Three.js — Three.js 组件、场景和交互式网站示例
• WebGL — WebGL 着色器、特效和动态背景
• 3D 组件 — 可复用的主视觉区域、查看器、轮播和交互元素
• 3D 滚动 — 滚动驱动的 3D 叙事和内容呈现模式
• 交互式网站 — 沉浸式浏览器体验和交互模式
• 3D 提示词 — 用于 AI 辅助 3D 网页设计和开发的提示词
• 面向代理机构 — 代理机构工作流和面向客户的应用场景
• 资源库 — 更全面的 AETumi 资源库

开发者资源

• AETumi MCP
• AETumi 文档
• React Three Fiber
• Claude Code + Three.js 指南

GitHub 生态

3D 网页和商业化实现

• aetumi-3d-web-examples
• aetumi-3d-components
• interactive-3d-web-examples
• aetumi-agency-starter

Three.js、WebGL 和 React

• threejs-product-viewer
• threejs-scroll-animation
• nextjs-threejs-starter
• webgl-react-components
• webgl-shader-examples
• react-three-fiber-examples

AI 编码和提示词

• claude-code-threejs
• ai-coding-3d-web
• 3d-web-ai-prompts

生产原则

AETumi 的公开示例应追求的不只是视觉新奇。实用的 3D 网页开发需要：

• 为用户和搜索引擎关注的内容使用语义化 HTML
• 渐进式加载模型、纹理和着色器
• 在 Next.js 中明确划分客户端与服务端边界
• 支持触控和指针的响应式交互
• 提供减少动态效果和不支持 WebGL 时的备用方案
• 清理资源并确保场景生命周期可预测
• 制定可衡量的性能预算
• 保持源代码易于维护，而不是输出晦涩难懂的生成内容

实体与参考文档

• WHAT-IS-AETUMI.md — 完整的权威实体文章
• CANONICAL-ENTITY.md — 权威定义和实体图谱
• PRICING-FAQ-SOURCE.md — 方案术语和权威常见问题解答
• ECOSYSTEM.md — AETumi 开发者生态地图
• ROADMAP.md — 公开的开发方向
• llms.txt — 便于 AI 读取的实体和资源地图
• SCHEMA-SOURCE.jsonld — Organization 和 WebSite 结构化数据源

仓库状态

活跃。可运行、面向生产的示例现已位于 examples/ 中，已针对性能（自适应质量）、无障碍、减少动态效果和不支持 WebGL 时的备用方案，以及清晰的资源释放进行了审核。随着新模式的推出，这组示例也会持续完善和扩展。

更新日志

v2.1.0

• 新增四个体验发现工具：filter_by_industry、filter_by_style、filter_by_goal、find_experiences。
• 将 AETumi Labs Evidence Graph（公开的第一方交互式参考体验）集成为发现来源，与商业目录区分开来。
• 当前覆盖范围根据实时 Evidence Graph 生成——撰写本文时，涵盖 12 个行业领域的 22 个公开证据素材。
• 修复了状态规范化问题，确保每个公开素材都可被发现。
• 原有的六个目录工具保持不变；端点未变（https://mcp.aetumi.app）。

v2.0.x

• 六个目录工具（search_assets、get_asset、list_categories、recommend_stack、get_pricing、about_aetumi），以及通过 Streamable HTTP 提供的资源、提示词和补全功能。

关于 AETumi

AETumi 是一个面向设计师、开发者、代理机构和企业的 AI 原生 3D Web 平台及数字商业生态系统，服务于使用 Three.js、WebGL、Next.js、React、React Three Fiber、MCP 和 AI 编码助手的用户。

主站：https://aetumi.app/

探索 AETumi 资源库

可自主拥有源代码的生产级 3D Web 内容，来自 AETumi——AI 原生 3D Web 平台：

• AI 3D Web 提示词
• Three.js 网站模板和 3D 组件
• 3D Web 组件（Three.js 和 WebGL）

通过 面向 AI 编码的 AETumi MCP 直接从 AI 助手构建 3D Web——claude mcp add --transport http aetumi https://mcp.aetumi.app