关键词

NFT生成区块链艺术AI策展3D折纸ShapeL2

项目简介

Katachi Gen（形現）是一个创新项目，它将您的ShapeL2区块链上的NFT收藏和链上活动转化为独一无二的3D折纸艺术品。通过AI情感分析您的收藏偏好，并结合算法策展，生成个性化的可打印折纸图案和互动式3D数字藏品。每个NFT都代表了您链上身份的一个独特快照，融合了数字与实体艺术的精髓。项目的核心功能由一个基于Model Context Protocol (MCP) 的服务器提供支持，负责访问链上数据、执行AI分析工具以及提供核心的生成逻辑。

主要功能点

  • NFT收藏分析: 深入分析您的ShapeL2钱包活动、勋章、收藏和所有NFT，作为艺术品生成的基础数据。
  • AI情感策展: 通过一个强大的MCP服务器工具，分析您对收藏艺术的感受，智能策展5个与您情感输入相匹配的NFT，作为折纸图案的纹理来源。
  • 3D折纸图案生成: 根据您的钱包数据和策展的NFT，生成独特的2D折纸图案（FOLD文件），并决定折叠的复杂程度。
  • 互动式3D NFT铸造: 将生成的折纸图案铸造成包含互动式3D可视化效果的HTML文件，永久存储在Arweave上，确保您的数字艺术品持久且可交互。
  • 可打印实体艺术: 每个NFT都包含可打印的文件，让您能将数字艺术带入现实，亲手折叠出实体作品。
  • MCP服务器集成: 内置MCP服务器实现，提供标准化接口供LLM客户端访问链上数据（Resources）和调用AI情感分析工具（Tools）。

安装步骤

本项目包含一个前端网站、一个Katachi生成器后端服务，以及一个Shape MCP服务器实现。

  1. 克隆仓库:

    git clone https://github.com/jmsaavedra/katachi-gen.git
cd katachi-gen

  2. 安装依赖:

    # 进入MCP服务器目录并安装依赖 (此目录包含核心MCP服务器实现)
cd mcp-server
npm install
# 返回主目录
cd ..
# 进入Katachi生成器目录并安装依赖 (此目录包含NFT生成逻辑和前端网站)
cd katachi-generator
npm install
# 返回主目录
cd ..
# 如果 public-site 是独立的 Next.js 应用，也需要安装依赖
# cd public-site
# npm install
# cd ..

  3. 环境变量配置: 在'katachi-generator'目录下创建'.env'文件，配置必要的环境变量。 例如：

    PORT=3001
ALCHEMY_API_KEY=YOUR_ALCHEMY_API_KEY
RARIBLE_API_KEY=YOUR_RARIBLE_API_KEY
ARWEAVE_WALLET='{"kty":"EC","crv":"P-256","x":"...","y":"..."}' # Arweave钱包JSON字符串
# Cloudflare R2配置 (如果使用)
R2_ACCOUNT_ID=YOUR_R2_ACCOUNT_ID
R2_ACCESS_KEY_ID=YOUR_R2_ACCESS_KEY_ID
R2_ACCESS_KEY_SECRET=YOUR_R2_ACCESS_KEY_SECRET
R2_BUCKET_NAME=katachi-gen
R2_PUBLIC_URL=https://pub-YOUR_PUBLIC_HASH.r2.dev # 或您的自定义域名
# MCP服务器的Redis URL (如果mcp-server需要)
# REDIS_URL=redis://localhost:6379
# Chrome/Chromium路径 (用于缩略图生成，如果需要手动指定)
# CHROME_PATH=/usr/bin/google-chrome

    注意: 'ARWEAVE_WALLET'是您的Arweave钱包密钥JSON字符串，请务必保护好。'ALCHEMY_API_KEY'和'RARIBLE_API_KEY'用于获取NFT元数据。

  4. 启动服务:

    # 启动MCP服务器 (根据mcp-server目录的实际入口文件调整)
cd mcp-server
# 假设MCP服务器的入口文件为 index.js
node index.js --port 8080 &
cd ..
# 启动Katachi生成器后端服务
cd katachi-generator
npm start &
# 假设 public-site 是独立的 Next.js 应用，也需要启动
# cd public-site
# npm run dev &

    MCP服务器通常在'8080'端口运行，Katachi生成器服务将在配置的端口（默认为3001）上运行。

服务器配置（供MCP客户端使用）

MCP客户端可以通过JSON-RPC协议与Katachi Gen仓库中包含的MCP服务器通信。为了连接该MCP服务器，您需要提供以下配置信息：

{
  "name": "KatachiGen MCP Server",
  "command": "node",
  "args": [
    "./mcp-server/index.js",
    "--port", "8080"
  ],
  "description": "提供Katachi Gen NFT生成所需的链上数据访问和AI情感分析工具。"
}

参数注释:

  • 'name': 服务器在MCP客户端界面中显示的名称。
  • 'command': 启动MCP服务器的命令。这里假设MCP服务器的主脚本通过Node.js运行。
  • 'args': 启动命令的参数列表。
    • './mcp-server/index.js': 这是MCP服务器的主入口脚本路径。请根据您'katachi-gen'仓库的实际克隆位置和'mcp-server'目录内的脚本名称进行调整。例如，如果您的MCP服务器脚本是'mcp-server/app.js'，则此处应为'./mcp-server/app.js'。
    • '--port 8080': 指定MCP服务器监听的端口号。请确保此端口与实际启动MCP服务器时使用的端口一致，并且没有被其他服务占用。
  • 'description': 对MCP服务器功能的简要描述，帮助用户了解其提供的能力。

基本使用方法

  1. 访问Katachi Gen前端: 在浏览器中访问Katachi Gen的前端网站，这通常在您本地运行于 'http://localhost:3000' 或您的部署环境中。
  2. 连接钱包: 使用支持ShapeL2的区块链钱包（如MetaMask）连接到网站。
  3. 情感输入: 根据网站提示，回答关于您NFT收藏的问题，例如您最喜欢收藏什么或您的收藏感受。这将用于驱动AI情感分析。
  4. 生成NFT: 提交您的情感输入后，Katachi Gen后端服务会通过其内部集成的MCP服务器，调用AI情感分析工具并访问您的链上数据。然后，它会为您生成独特的3D折纸NFT。
  5. 查看与铸造: 预览您生成的互动式3D折纸NFT。如果满意，您可以选择将其铸造到ShapeL2区块链上。铸造成功后，您可以在ShapeScan或其他兼容的市场查看您的NFT，并下载可打印的折纸文件，将其变为实体艺术品。

信息

分类

AI与计算

访问项目