Uranium MCP Server

铀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://anysphere.cursor-deeplink/mcp/install?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)

或者手动安装：

首选 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

发展

从源代码构建

1. 克隆仓库：

git clone https://github.com/xkelxmc/uranium-mcp.git
cd uranium-mcp

1. 安装依赖项：

npm install

1. 构建项目：

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

故障排除

常见问题

1. API密钥无法使用请确保您的API密钥有效，并且在（某处）拥有必要的权限 "portal.uranium.pro" 翻译成中文可以是“铀门户网站（或铀信息平台）.pro”。不过，这里的“.pro”是一个顶级域名，通常用于专业服务提供商，所以在中文语境下，我们可能会更倾向于将其翻译为“铀专业门户网站（或铀信息专业平台）”，以更准确地传达“.pro”域名的含义。但具体翻译还需根据上下文和语境来确定

1. 连接错误检查 URANIUM_BASE_URL 是否正确（默认值为 https://gw.urnm.pro）

1. 文件上传问题确保文件路径是绝对路径且文件存在

1. 集合创建失败验证集合名称和符号是否符合要求的格式（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”是域名后缀，通常用于表示专业性或商业性质的网站，但具体翻译时可能需要结合网站的实际内容和语境来灵活处理