NFT合约部署服务器

一个MCP服务器,使兼容MCP的AI客户端能够通过自然语言在SuperRare上部署NFT合约、铸造代币和运行拍卖。

  • by Deconstruct2021
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 Deconstruct2021/rare-protocol-mcp-server

使用说明

稀有协议mcp服务器

MCP(模型上下文协议)服务器,用于封装 RARE协议CLI,使任何兼容MCP的AI客户端都可以直接从自然语言部署NFT合约、铸造代币并在SuperRare上运行拍卖。

为 2026年综合黑客马拉松 --由SuperRare赞助。

综合评委须知: 此服务器已准备好进行测试。安装rare-cli,配置Sepolia钱包,将此服务器添加到您的MCP客户端,并要求它部署合约并创建NFT。整个生命周期是端到端的。


这是什么?

RARE协议为SuperRare的NFT销售额提供了3亿美元以上的动力。此MCP服务器将整个协议表面作为结构化AI工具公开,因此代理可以:

  • 在以太坊上部署品牌ERC-721集合
  • 一步完成带有IPFS媒体上传的Mint NFT
  • 创建、出价、结算和取消拍卖
  • 搜索代币、拍卖和收藏
  • 链合约和代币状态查询

法官是人工智能的代理人。他们可以使用此服务器创建NFT并在评估期间进行拍卖。


先决条件

安装此MCP服务器之前,请按顺序完成以下步骤:

第一步——安装Node.js 22+

下载自 nodejs.org.验证:

node --version   # must be v22.x or higher

步骤2--全局安装rare cli

npm install -g @rareprotocol/rare-cli

验证:

rare --help

步骤3--配置您的钱包

导入您现有的私钥(建议:使用专用的热钱包,而不是主钱包):

rare configure --chain sepolia --private-key 0xYOUR_PRIVATE_KEY --rpc-url https://YOUR_RPC_URL
rare configure --default-chain sepolia

从获取免费RPC URL 炼金术 或 英富拉 --公共端点是速率受限的。

免费获取Sepolia testnet ETH sepoliafucet.com.

验证您的设置:

rare configure --show
rare wallet address

步骤4--安装克劳德桌面或克劳德代码

  • 克劳德桌面版:从下载 claude.ai/下载
  • 克劳德代码: npm install -g @anthropic-ai/claude-code

完成所有四个步骤后,安装此MCP服务器。


安装

git clone https://github.com/Deconstruct2021/rare-protocol-mcp-server
cd rare-protocol-mcp-server
npm install
npm run build

配置

克劳德桌面版

查找您的配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: C:\Users\YOU\AppData\Roaming\Claude\claude_desktop_config.json

添加 rare-protocol 条目:

{
  "mcpServers": {
    "rare-protocol": {
      "command": "node",
      "args": ["/path/to/rare-protocol-mcp-server/dist/index.js"],
      "env": {
        "RARE_CLI_PATH": "/usr/local/bin/rare"
      }
    }
  }
}

windows用户 --使用带有双反斜杠的完整路径:

{
  "mcpServers": {
    "rare-protocol": {
      "command": "node",
      "args": ["C:\\Users\\YOU\\rare-protocol-mcp-server\\dist\\index.js"],
      "env": {
        "RARE_CLI_PATH": "C:\\Users\\YOU\\AppData\\Roaming\\npm\\rare.cmd"
      }
    }
  }
}

找到你的 RARE_CLI_PATH 通过运行:

where rare        # Windows
which rare        # macOS / Linux

保存配置后完全退出并重新启动Claude Desktop。

克劳德代码

claude mcp add rare-protocol node /path/to/rare-protocol-mcp-server/dist/index.js

在Sepolia和主网之间切换

此服务器默认为 Sepolia测试网 --安全测试,无实际资金风险。

永久切换到主网

rare configure --default-chain mainnet
rare configure --chain mainnet --rpc-url https://YOUR_MAINNET_RPC_URL

从获取主网RPC URL 炼金术 --创建新应用程序并选择 以太坊主网.

使用主网处理单个请求

只需在您的请求中说“在主网上”,代理就会通过 --chain mainnet 自动:

在主网上部署一个名为“YOUR collection NAME”的集合,符号为“SYMBL”

在进入主网之前很重要

  • 确保你的钱包里有真正的ETH(0.1 ETH足以进行多次操作)
  • 始终首先在Sepolia上进行全面的试运行
  • 仔细检查所有参数——链上交易是不可逆的

工具

工具 描述 只读
rare_configure_show 显示钱包和RPC配置 ✓
rare_wallet_address 获取配置的钱包地址 ✓
rare_deploy_contract 部署ERC-721集合
rare_import_contract 将现有合同导入注册表
rare_mint_nft 使用本地媒体或IPFS URI创建NFT
rare_auction_create 创建底价拍卖
rare_auction_bid 拍卖出价
rare_auction_settle 结算已完成的拍卖
rare_auction_cancel 取消拍卖(仅限出价)
rare_auction_status 检查拍卖状态 ✓
rare_search_tokens 搜索NFT ✓
rare_search_auctions 按州搜索拍卖 ✓
rare_search_collections 搜索收藏 ✓
rare_status 查询链上合约/代币状态 ✓

代理工作流示例

询问任何兼容MCP的AI客户端:

“在Sepolia上部署一个名为'FRAME OF MIND'的新NFT系列,符号为'FOM',在/art/Arrival.png上铸造一件名为'Arrival'的图片,然后创建一个24小时拍卖,储备0.1 ETH。”

代理人将:

  1. 呼叫 rare_configure_show --验证钱包和链
  2. 呼叫 rare_deploy_contract --获取合同地址
  3. 呼叫 rare_mint_nft --获取令牌ID
  4. 呼叫 rare_auction_create --拍卖现场直播

没有代码。没有UI。纯自然语言上链。


支撑链

链 部署+拍卖 钱包+搜索
主网 ✓ ✓
威立雅 ✓ ✓
基础 ✓
基础sepolia✓
仲裁
乐观主义✓
佐拉 ✓

合同地址

合同 主网 Sepolia
工厂 0xAe8E375a268Ed6442bEaC66C6254d6De5AeD4aB1 0x3c7526a0975156299ceef369b8ff3c01cc670523
拍卖 0x6D7c44773C52D396F43c2D511B81aa168E9a7a42 0xC8Edc7049b233641ad3723D6C60019D1c8771612

安全

  • 私钥存储在 ~/.rare/config.json --从不在此服务器中
  • 所有破坏性工具(mint、拍卖、部署)都需要显式的代理调用
  • 在主网之前,始终在Sepolia上进行测试
  • 永远不要分享你的 ~/.rare/config.json
  • 使用专用的热钱包——不要使用主钱包

发展

npm run dev    # run with tsx (no build step)
npm run build  # compile TypeScript
npm start      # run compiled server

MCP检验员测试:

npx @modelcontextprotocol/inspector node dist/index.js

项目结构

src/
├── index.ts          # Server entry point
├── constants.ts      # Chain addresses, CLI path
├── cli.ts            # rare-cli execution utility
└── tools/
    ├── wallet.ts     # configure_show, wallet_address
    ├── deploy.ts     # deploy_contract, import_contract
    ├── mint.ts       # mint_nft
    ├── auction.ts    # auction_create/bid/settle/cancel/status
    └── search.ts     # search_tokens/auctions/collections, status

建造于

解构实验室 --SuperRare上的生成性视听艺术家。

专为2026年综合黑客马拉松而建。


许可证

麻省理工学院