mcpField
U
Uranium Mcp

Uranium Mcp

本地服务
github.com/xkelxmc金融数据159 周前更新

关于 Uranium Mcp

Uranium Mcp 是通过 portal.uranium.pro 创建和管理 NFT 集合及资产的 MCP 服务。它支持 ERC721 和 ERC1155 集合,并允许 LLM 客户端从本地文件或 base64 数据创建资产。

主要功能

  1. 01列出和创建集合
  2. 02支持 ERC721 与 ERC1155
  3. 03从文件或 base64 创建资产
  4. 04列出、搜索和分页资产
  5. 05支持图片、视频、音频和文档

适用场景

  1. 01创建 NFT 集合
  2. 02从媒体文件铸造资产
  3. 03查找多个集合中的资产
  4. 04管理 ERC1155 资产的发行份数

MCP 相关

它向 MCP 客户端提供四种 NFT 管理工具:列出和创建集合,以及列出和创建资产。操作通过 Uranium API 执行,并需要 Uranium API 密钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"uranium": {
"command": "npx",
"args": [
"-y",
"uranium-tools-mcp"
],
"env": {
"URANIUM_API_KEY": "<URANIUM_API_KEY>"
}
}
}
}
启动命令npx -y uranium-tools-mcp
需要配置的环境变量
URANIUM_API_KEY密钥You can generate an API key from your Uranium account settings: https://portal.uranium.pro/dashboard/profile/api-keys

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmuranium-tools-mcp1.0.9

工具

4

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Uranium MCP 服务

🚀 快速安装

在 VS Code 中安装 在 VS Code Insiders 中安装 在 Cursor 中安装 在 Goose 中安装 在 LM Studio 中安装

一个用于与 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 中安装

或手动安装:

前往 Cursor Settings -> MCP -> Add new MCP Server。将其命名为 "uranium",选择 command 类型,并使用命令 npx uranium-tools-mcp@latest。添加环境变量 URANIUM_API_KEY,并填入你的 API 密钥。

Gemini CLI

按照 MCP 安装指南操作,使用上方的标准配置并填入你的 API 密钥。

Goose
点击按钮安装:

在 Goose 中安装

或手动安装:

前往 Advanced settings -> Extensions -> Add custom extension。将其命名为 "uranium",选择 STDIO 类型,并将 command 设置为 npx uranium-tools-mcp@latest。添加环境变量 URANIUM_API_KEY,并填入你的 API 密钥。点击 "Add Extension"。

LM Studio
点击按钮安装:

将 MCP 服务 uranium 添加到 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

在 VSCode 或 IntelliJ 中打开 Qodo Gen 聊天面板 → Connect more tools → + Add new MCP → 粘贴上方的标准配置并填入你的 API 密钥。

点击 Save。

VS Code #### 点击按钮进行安装:

在 VS Code 中安装 在 VS Code Insiders 中安装

或手动安装:

按照 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,必填):要在其中铸造资产的集合 ID
    • title(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
开发
从源代码构建
  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 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
故障排除
常见问题
  1. API Key 无法使用:请确保 API key 有效,并且在 portal.uranium.pro 具有必要的权限

  2. 连接错误:检查 URANIUM_BASE_URL 是否正确(默认为 https://gw.urnm.pro)

  3. 文件上传问题:确保文件路径为绝对路径,且文件存在

  4. 创建集合失败:确认集合名称和符号符合所需格式(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
许可证

待定

支持

如有问题或疑问:

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。