使用说明

铀MCP服务器

🚀 快速安装

一个用于协同工作的模型上下文协议（MCP）服务器 portal.uranium.pro 翻译为中文可以是“铀门户网站”或“铀资源门户”，具体取决于该网站的具体内容和定位。在这里，“portal”通常指的是一个提供信息、资源或服务的集中访问点，而“uranium”则明确指向了与铀相关的主题或内容。因此，一个较为通用且直观的翻译是“铀门户网站” - 创建和管理NFT收藏品和资产。该服务器使大型语言模型（LLMs）能够通过简单、结构化的接口与区块链上的NFT进行交互。

主要特点

快速高效的NFT管理直接与Uranium API集成以实现即时操作。
多集合支持无缝管理ERC721和ERC1155 NFT收藏品。
基于文件的资产创建直接上传图片、视频、音频和文档作为NFT。
批量操作列出并跨多个集合过滤资产，支持分页。

要求

Node.js 18 或更高版本
铀API密钥来自 “portal.uranium.pro”翻译成中文可以是“铀门户网站.pro”或“铀资源门户网.pro”，具体翻译可能根据上下文或网站的具体内容有所调整。不过，需要注意的是，“.pro”是域名后缀，通常用于表示专业服务或个人专业网站，但在这里直接翻译时，我们保留了原样以表示这是一个特定的域名
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" }

如需更多信息，请参阅 MCP典籍文档。

Cursor

点击按钮进行安装：

或者手动安装：

首选 Cursor Settings -> MCP -> Add new MCP Server将其命名为“铀”，使用 command 使用命令输入类型 npx uranium-tools-mcp@latest添加环境变量 URANIUM_API_KEY 使用您的API密钥。

Gemini CLI

按照MCP安装指南进行安装指南/引导使用上面的标准配置和您的API密钥。

Goose

点击按钮进行安装：

或者手动安装：

首选 Advanced settings → Extensions -> Add custom extension将其命名为“铀”，使用类型 STDIO，并设置 command 到；朝；对于；为了 npx uranium-tools-mcp@latest添加环境变量 URANIUM_API_KEY 使用您的API密钥。点击“添加扩展”。

LM Studio

点击按钮进行安装：

或者手动安装：

首选 Program 在右侧边栏中 -> Install -> Edit mcp.json使用上面的标准配置，并输入您的API密钥。

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

开放 Qodo Gen（注：此名称可能为特定产品、品牌或技术的名称，无直接对应的中文翻译，故保留原样） VSCode或IntelliJ中的聊天面板 → 连接更多工具 → + 添加新的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"}}'

安装完成后，Uranium MCP 服务器即可在 VS Code 中与您的 GitHub Copilot 代理一起使用。

Windsurf

跟随风帆冲浪MCP（多点触控面板/移动控制面板，具体根据上下文确定）文件、文档使用上面的标准配置，并填入您的API密钥。

配置

环境变量

URANIUM_API_KEY （必填）：您的铀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管理工具：

Collection Management

列出集合（或：列举集合）

描述列出所有用户集合（个人、公共和外部）
参数无

创建集合

描述创建一个新的NFT系列
参数：
- name (字符串，必填)：集合名称（3-30个字符，可包含字母、数字和[_.-]符号）[最小长度：3，最大长度：30]
- symbol （字符串，必填）：集合符号（3-30个字符，可包含字母、数字和下划线）[最小长度：3，最大长度：30]
- type (字符串，枚举：ERC721，ERC1155，必填)：集合类型：ERC721（单个NFT）或ERC1155（多代币）

Asset Management

列出资产

描述列出资产，并可选择按集合、搜索和分页进行过滤
参数:
- contractId （字符串，可选）：按集合ID过滤资产
- page （数字，可选）：页码（默认：1）[最小值：1，默认：1]
- pageSize (数字，可选)：每页显示的资产数量（默认：20，最大：100）[最小：1，最大：100，默认：20]
- sortBy (字符串，可选)：排序字段（默认：createdAt）[默认值："createdAt"]
- order (字符串，枚举值：asc, desc，可选)：排序顺序（默认：asc）[默认值："asc"]
- quickFilter （字符串，可选）：用于按标题筛选资源的搜索文本

创建资产

描述从本地文件或base64数据创建一个新的NFT资产
参数：
- filePath （字符串，可选）：媒体文件的绝对路径（针对本地文件）
- fileData (字符串，可选)：Base64 编码的文件数据（用于 Claude Desktop）
- fileName （字符串，可选）：原始文件名（在使用fileData时必需）
- mimeType （字符串，可选）：文件的MIME类型（当使用fileData时必需，例如，'image/png'）
- contractId （字符串，必填）：铸造资产时所属的集合ID
- title (字符串，必填)：资产标题（3-120个字符）[最小长度：3，最大长度：120]
- description (字符串，可选)：资产描述（可选，最多255个字符）[最大长度：255]
- location (字符串，可选)：资产创建位置（可选，最多100个字符）[最大长度：100]
- editions （数字，可选）：版次数量（仅适用于ERC1155系列，1-1000）[最小值：1，最大值：1000]
- shareWithCommunity （布尔值，可选）：使资产可被社区发现（可选，默认值：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检查器

使用以下方法测试您的MCP服务器 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密钥无法使用请确保您的API密钥有效，并且在（某处）拥有必要的权限 "portal.uranium.pro" 翻译成中文可以是“铀门户网站（或铀信息平台）.pro”。不过，这里的“.pro”是一个顶级域名，通常用于专业服务提供商，所以在中文语境下，我们可能会更倾向于将其翻译为“铀专业门户网站（或铀信息专业平台）”，以更准确地传达“.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 翻译为中文是“铀.专业”或“铀.点专业”（根据具体语境，可能更倾向于使用“铀.专业”作为简洁明了的表述）。不过，需要注意的是，“.pro”是域名后缀，通常用于表示专业性或商业性质的网站，但具体翻译时可能需要结合网站的实际内容和语境来灵活处理

使用说明

铀MCP服务器

🚀 快速安装

主要特点

要求

入门指南/开始使用

点击按钮进行安装：

或者手动安装：

点击按钮进行安装：

或者手动安装：

点击按钮进行安装：

或者手动安装：

点击按钮进行安装：

或者手动安装：

配置

环境变量

示例配置

本地安装

工具

列出集合（或：列举集合）

创建集合

列出资产

创建资产

支持的文件格式

发展

从源代码构建

开发命令

测试

使用MCP检查器

开发测试

故障排除

常见问题

项目结构

许可证

支持

相关 MCP

Web3开发库

加密货币守护进程MCP服务器

区块链CLI工具包

钱包批量生成工具

跨链桥接汇率服务器

MCP工作主机适配器