关于 Uranium Mcp
Uranium Mcp 是通过 portal.uranium.pro 创建和管理 NFT 集合及资产的 MCP 服务。它支持 ERC721 和 ERC1155 集合,并允许 LLM 客户端从本地文件或 base64 数据创建资产。
主要功能
- 01列出和创建集合
- 02支持 ERC721 与 ERC1155
- 03从文件或 base64 创建资产
- 04列出、搜索和分页资产
- 05支持图片、视频、音频和文档
适用场景
- 01创建 NFT 集合
- 02从媒体文件铸造资产
- 03查找多个集合中的资产
- 04管理 ERC1155 资产的发行份数
MCP 相关
它向 MCP 客户端提供四种 NFT 管理工具:列出和创建集合,以及列出和创建资产。操作通过 Uranium API 执行,并需要 Uranium API 密钥。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
4收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
Uranium MCP 服务
🚀 快速安装
一个用于与 portal.uranium.pro 配合使用的模型上下文协议(MCP)服务,可创建和管理 NFT 收藏集及资产。此服务让大模型能够通过简单、结构化的界面与区块链 NFT 交互。
主要功能
- 快速、高效的 NFT 管理。直接集成 Uranium API,即时执行操作。
- 支持多个收藏集。无缝管理 ERC721 和 ERC1155 NFT 收藏集。
- 基于文件创建资产。直接将图像、视频、音频和文档作为 NFT 上传。
- 批量操作。通过分页功能,跨多个收藏集列出和筛选资产。
要求
- Node.js 18 或更高版本
- 从 portal.uranium.pro 获取 Uranium API 密钥
- VS Code、Cursor、Windsurf、Claude Desktop、Goose 或任何其他 MCP 客户端
快速入门
首先,使用你的客户端安装 Uranium MCP 服务。
标准配置适用于大多数工具:
{
"mcpServers": {
"uranium": {
"command": "npx",
"args": ["uranium-tools-mcp@latest"],
"env": {
"URANIUM_API_KEY": "your_api_key_here"
}
}
}
}
Claude Code
使用 Claude Code CLI 添加 Uranium MCP 服务:
claude mcp add uranium npx uranium-tools-mcp@latest
然后在出现提示时设置 URANIUM_API_KEY。
Claude Desktop
将以下内容添加到 Claude Desktop 配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"uranium": {
"command": "npx",
"args": ["uranium-tools-mcp@latest"],
"env": {
"URANIUM_API_KEY": "your_api_key_here"
}
}
}
}
Codex
创建或编辑配置文件 ~/.codex/config.toml,并添加:
[mcp_servers.uranium]
command = "npx"
args = ["uranium-tools-mcp@latest"]
env = { URANIUM_API_KEY = "your_api_key_here" }
更多信息请参阅 Codex MCP 文档。
Cursor
点击按钮安装:
或手动安装:
前往 Cursor Settings -> MCP -> Add new MCP Server。将其命名为 "uranium",选择 command 类型,并使用命令 npx uranium-tools-mcp@latest。添加环境变量 URANIUM_API_KEY,并填入你的 API 密钥。
Gemini CLI
按照 MCP 安装指南操作,使用上方的标准配置并填入你的 API 密钥。
Goose
点击按钮安装:
或手动安装:
前往 Advanced settings -> Extensions -> Add custom extension。将其命名为 "uranium",选择 STDIO 类型,并将 command 设置为 npx uranium-tools-mcp@latest。添加环境变量 URANIUM_API_KEY,并填入你的 API 密钥。点击 "Add Extension"。
opencode
按照 MCP 服务文档操作。例如,在 ~/.config/opencode/opencode.json 中:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"uranium": {
"type": "local",
"command": [
"npx",
"uranium-tools-mcp@latest"
],
"env": {
"URANIUM_API_KEY": "your_api_key_here"
},
"enabled": true
}
}
}
Qodo Gen
在 VSCode 或 IntelliJ 中打开 Qodo Gen 聊天面板 → Connect more tools → + Add new MCP → 粘贴上方的标准配置并填入你的 API 密钥。
点击 Save。
VS Code
#### 点击按钮进行安装:或手动安装:
按照 MCP 安装指南操作,并使用上面的标准配置。你也可以使用 VS Code CLI 安装 Uranium MCP 服务:
# For VS Code
code --add-mcp '{"name":"uranium","command":"npx","args":["uranium-tools-mcp@latest"],"env":{"URANIUM_API_KEY":"your_api_key_here"}}'
安装后,即可在 VS Code 中将 Uranium MCP 服务与 GitHub Copilot Agent 搭配使用。
Windsurf
按照 Windsurf MCP 文档操作。使用上面的标准配置,并填入你的 API 密钥。
配置
环境变量
URANIUM_API_KEY(必需):你的 Uranium API 密钥,可从 portal.uranium.pro 获取URANIUM_BASE_URL(可选):API 基础 URL。默认为https://gw.urnm.pro
配置示例
{
"mcpServers": {
"uranium": {
"command": "npx",
"args": ["uranium-tools-mcp@latest"],
"env": {
"URANIUM_API_KEY": "your_api_key_here"
// URANIUM_BASE_URL is optional, defaults to https://gw.urnm.pro
}
}
}
}
本地安装
如果你希望在本地安装:
npm install -g uranium-tools-mcp
# or
pnpm add -g uranium-tools-mcp
# or
yarn global add uranium-tools-mcp
然后在配置中使用 uranium-tools-mcp,而不是 npx uranium-tools-mcp@latest。
工具
此 MCP 服务提供 4 个用于 NFT 管理的主要工具:
合集管理
list_collections
- Description:列出所有用户合集(个人、公共和外部合集)
- Parameters:无
create_collection
- Description:创建新的 NFT 合集
- Parameters:
name(字符串,必需):合集名称(3-30 个字符,包含字母、数字和 [_.-] 符号)[最小长度:3,最大长度:30]symbol(字符串,必需):合集符号(3-30 个字符,包含字母、数字和下划线)[最小长度:3,最大长度:30]type(字符串,枚举:ERC721、ERC1155,必需):合集类型:ERC721(单个 NFT)或 ERC1155(多代币)
资产管理
list_assets
- Description:列出资产,可按合集、搜索词和分页进行筛选
- Parameters:
contractId(字符串,可选):按合集 ID 筛选资产page(数字,可选):页码(默认值:1)[最小值:1,默认值:1]pageSize(数字,可选):每页资产数(默认值:20,最大值:100)[最小值:1,最大值:100,默认值:20]sortBy(字符串,可选):排序字段(默认值:createdAt)[默认值:"createdAt"]order(字符串,枚举:asc、desc,可选):排序顺序(默认值:asc)[默认值:"asc"]quickFilter(字符串,可选):用于按标题筛选资产的搜索文本
create_asset
- 描述:从本地文件或 base64 数据创建新的 NFT 资产
- 参数:
filePath(string,可选):媒体文件的绝对路径(用于本地文件)fileData(string,可选):Base64 编码的文件数据(用于 Claude Desktop)fileName(string,可选):原始文件名(使用 fileData 时必填)mimeType(string,可选):文件的 MIME 类型(使用 fileData 时必填,例如:'image/png')contractId(string,必填):要在其中铸造资产的集合 IDtitle(string,必填):资产标题(3-120 个字符)[最小长度:3,最大长度:120]description(string,可选):资产描述(可选,最多 255 个字符)[最大长度:255]location(string,可选):资产的创建地点(可选,最多 100 个字符)[最大长度:100]editions(number,可选):版本数量(仅适用于 ERC1155 集合,1-1000)[最小值:1,最大值:1000]shareWithCommunity(boolean,可选):让社区能够发现该资产(可选,默认值:false)[默认值:false]
支持的文件格式
- 图像:JPG、JPEG、PNG、GIF、WebP、SVG
- 视频:MP4、WebM、MOV、AVI
- 音频:MP3、WAV、OGG
- 文档:PDF、TXT
开发
从源代码构建
- 克隆仓库:
git clone https://github.com/xkelxmc/uranium-mcp.git
cd uranium-mcp
- 安装依赖:
npm install
- 构建项目:
npm run build
开发命令
# Compile in watch mode
npm run dev
# Build for production
npm run build
# Start server locally
npm start
# Clean build directory
npm run clean
测试
使用 MCP Inspector
使用 MCP Inspector 测试你的 MCP 服务:
# For installed version
npx @modelcontextprotocol/inspector uranium-tools-mcp
# For local development
npm run build:dev
npx @modelcontextprotocol/inspector node build/index.js
开发测试
# Test with stdio transport
npm run dev:stdio
# Test with HTTP transport
npm run dev:http
# Inspect with HTTP transport
npm run mcp:inspect
故障排除
常见问题
-
API Key 无法使用:请确保 API key 有效,并且在 portal.uranium.pro 具有必要的权限
-
连接错误:检查 URANIUM_BASE_URL 是否正确(默认为
https://gw.urnm.pro) -
文件上传问题:确保文件路径为绝对路径,且文件存在
-
创建集合失败:确认集合名称和符号符合所需格式(3-30 个字符,由字母数字字符和下划线组成)
项目结构
src/
├── api/ # Complete copy of Uranium API from Raycast
├── utils/ # Utilities for validation, formatting, etc.
├── models/ # Upload primitives for working with files
├── tools/ # MCP tools
├── server.ts # MCP server configuration
├── index.ts # Entry point
└── config.ts # API and MCP configuration
许可证
待定
支持
如有问题或疑问:
- 请通过 uranium.pro 联系支持团队
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。