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+

下载自 .验证：

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上进行全面的试运行
• 仔细检查所有参数——链上交易是不可逆的

______________________________________________________________________

工具

______________________________________________________________________

代理工作流示例

询问任何兼容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。纯自然语言上链。

______________________________________________________________________

支撑链

______________________________________________________________________

合同地址

______________________________________________________________________

安全

• 私钥存储在 ~/.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年综合黑客马拉松而建。

______________________________________________________________________

许可证

麻省理工学院