Story SDK MCP Server

Story SDK MCP Server

用于故事 SDK 的MCP Server。

GitHub
Created Bypiplabspiplabs

概述

Story SDK MCP Server 提供与 Python SDK 交互所需的 MCP（模型上下文协议）工具，用于管理 IP 资产、许可证和元数据。

安装设置

  1. 安装依赖项:

    curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync

  2. 配置环境变量:

    cp .env.example .env

    编辑 .env 文件并填写以下信息:

    • WALLET_PRIVATE_KEY: 您的 EVM 钱包私钥
    • RPC_PROVIDER_URL: RPC 提供者 URL (可使用默认值)
    • SPG_NFT_CONTRACT: SPG NFT 合约地址 (可使用默认值)
    • PINATA_JWT: [可选] 用于元数据上传的 Pinata JWT，可从 pinata.cloud 获取

  3. 启动服务器:

    uv run mcp dev server.py

主要功能

  • 获取许可条款
  • 使用 PIL 条款铸造并注册 IP 资产
  • 铸造许可令牌
  • 发送 $IP 代币
  • 通过 Pinata 上传图片和元数据至 IPFS

使用示例

铸造并注册 IP 资产

使用 mint_and_register_ip_with_terms 工具:

{
  "commercial_rev_share": 5,
  "derivatives_allowed": true,
  "registration_metadata": {
    "ip_metadata_uri": "https://azure-wooden-quail-605.mypinata.cloud/ipfs/QmcvC23URQPKSHYB9Xy5AFswy2SKqUYPRg7iYtL5ZqEi7b",
    "ip_metadata_hash": "0xe74a304f3ca32924cef88f7445eca413ff8f80d265417bfc93d6765bb26e4dec",
    "nft_metadata_uri": "https://azure-wooden-quail-605.mypinata.cloud/ipfs/QmegKQTYSeaNgKBncYTPWMJeykHVwDgsiFf493fkXBaWcb",
    "nft_metadata_hash": "0x5c6e29420f759a5cc6497ad1d564db70e2742790f4123225a093209ad55340d7"
  }
}

其他可用工具

  • get_license_terms: 检索特定 ID 的许可条款
  • mint_license_tokens: 为 IP 铸造许可令牌
  • send_ip: 将 IP 代币发送到指定地址
  • upload_image_to_ipfs: 将图片上传至 IPFS
  • create_ip_metadata: 创建 NFT 元数据

兼容性

MCP Server 可与任何兼容 MCP 的客户端一起使用，通过 MCP 协议暴露工具，支持多种 AI 框架。