🚀 Uranium MCP Server
Uranium MCP Server 是一個用於與 portal.uranium.pro 協作的模型上下文協議（MCP）服務器，可用於創建和管理 NFT 集合與資產。該服務器使大語言模型（LLMs）能夠通過簡單、結構化的接口與區塊鏈 NFT 進行交互。
🚀 快速開始
首先，使用您的客戶端安裝 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 服務器：
```bash
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` 並添加：
```toml
[mcp_servers.uranium]
command = "npx"
args = ["uranium-tools-mcp@latest"]
env = { URANIUM_API_KEY = "your_api_key_here" }
```
更多信息，請參閱 [Codex MCP 文檔](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers)。
Cursor
#### 點擊按鈕安裝：
[](cursor://anysphere.cursor-deeplink/mcp/install?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)
或手動安裝：
轉到 Cursor 設置 -> MCP -> 添加新的 MCP 服務器。將其命名為 "uranium"，使用 命令 類型並輸入命令 npx uranium-tools-mcp@latest。添加環境變量 URANIUM_API_KEY 並輸入您的 API 密鑰。
Gemini CLI
遵循 MCP 安裝 [指南](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#configure-the-mcp-server-in-settingsjson)，使用上述標準配置並輸入您的 API 密鑰。
Goose
#### 點擊按鈕安裝：
[](https://block.github.io/goose/extension?cmd=npx&arg=uranium-tools-mcp%40latest&id=uranium&name=Uranium&description=MCP%20for%20Uranium%20NFT%20tools%20to%20mint%2C%20list%2C%20and%20manage%20digital%20assets%20on%20the%20permaweb.)
或手動安裝：
轉到 高級設置 -> 擴展 -> 添加自定義擴展。將其命名為 "uranium"，使用類型 STDIO，並將 命令 設置為 npx uranium-tools-mcp@latest。添加環境變量 URANIUM_API_KEY 並輸入您的 API 密鑰。點擊 "添加擴展"。
LM Studio
#### 點擊按鈕安裝：
[](https://lmstudio.ai/install-mcp?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)
或手動安裝：
轉到右側邊欄的 程序 -> 安裝 -> 編輯 mcp.json。使用上述標準配置並輸入您的 API 密鑰。
opencode
遵循 MCP 服務器 [文檔](https://opencode.ai/docs/mcp-servers/)。例如，在 `~/.config/opencode/opencode.json` 中：
```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](https://docs.qodo.ai/qodo-documentation/qodo-gen) 聊天面板 → 連接更多工具 → + 添加新的 MCP → 粘貼上述標準配置並輸入您的 API 密鑰。
點擊 `保存`。
VS Code
#### 點擊按鈕安裝：
[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522uranium%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uranium-tools-mcp%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522URANIUM_API_KEY%2522%253A%2522your_api_key_here%2522%257D%257D%257D) [](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522uranium%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uranium-tools-mcp%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522URANIUM_API_KEY%2522%253A%2522your_api_key_here%2522%257D%257D%257D)
或手動安裝：
遵循 MCP 安裝 指南，使用上述標準配置。您也可以使用 VS Code CLI 安裝 Uranium MCP 服務器：
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
遵循 Windsurf MCP [文檔](https://docs.windsurf.com/windsurf/cascade/mcp)。使用上述標準配置並輸入您的 API 密鑰。
✨ 主要特性
- 快速高效的 NFT 管理：直接與 Uranium API 集成，實現即時操作。
- 多集合支持：無縫管理 ERC721 和 ERC1155 NFT 集合。
- 基於文件的資產創建：直接上傳圖像、視頻、音頻和文檔作為 NFT。
- 批量操作：通過分頁跨多個集合列出和過濾資產。
📦 安裝指南
環境變量
URANIUM_API_KEY（必需）：您從 portal.uranium.pro 獲取的 Uranium API 密鑰。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"
}
}
}
}
本地安裝
如果您更喜歡本地安裝：
npm install -g uranium-tools-mcp
pnpm add -g uranium-tools-mcp
yarn global add uranium-tools-mcp
然後在配置中使用 uranium-tools-mcp 代替 npx uranium-tools-mcp@latest。
💻 使用示例
工具
此 MCP 服務器提供了 4 個主要的 NFT 管理工具：
集合管理
#### list_collections
- **描述**：列出所有用戶集合（個人、公共和外部）。
- **參數**：無。
create_collection
- 描述：創建一個新的 NFT 集合。
- 參數：
name（字符串，必需）：集合名稱（3 - 30 個字符，字母、數字和 [_.-] 符號）[最小長度：3，最大長度：30]。symbol（字符串，必需）：集合符號（3 - 30 個字符，字母、數字和下劃線）[最小長度：3，最大長度：30]。type（字符串，枚舉：ERC721，ERC1155，必需）：集合類型：ERC721（單個 NFT）或 ERC1155（多代幣）。
資產管理
#### list_assets
- **描述**：列出資產，並可選擇按集合、搜索和分頁進行過濾。
- **參數**：
- `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（字符串，可選）：媒體文件的絕對路徑（適用於本地文件）。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
開發命令
npm run dev
npm run build
npm start
npm run clean
測試
使用 MCP 檢查器
使用 MCP 檢查器 測試您的 MCP 服務器：
npx @modelcontextprotocol/inspector uranium-tools-mcp
npm run build:dev
npx @modelcontextprotocol/inspector node build/index.js
開發測試
npm run dev:stdio
npm run dev:http
npm run mcp:inspect
故障排除
常見問題
- API 密鑰無效：確保您的 API 密鑰有效，並在 portal.uranium.pro 具有必要的權限。
- 連接錯誤：檢查
URANIUM_BASE_URL 是否正確（默認為 https://gw.urnm.pro）。
- 文件上傳問題：確保文件路徑是絕對路徑，並且文件存在。
- 集合創建失敗：驗證集合名稱和符號是否遵循所需格式（3 - 30 個字符，字母數字和下劃線）。
項目結構
src/
├── api/ # 來自 Raycast 的 Uranium API 完整副本
├── utils/ # 用於驗證、格式化等的實用工具
├── models/ # 用於處理文件的上傳原語
├── tools/ # MCP 工具
├── server.ts # MCP 服務器配置
├── index.ts # 入口點
└── config.ts # API 和 MCP 配置
📄 許可證
待補充
📚 詳細文檔
支持
如有問題和疑問：
%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%23061b40;%20}%20.st1%20{%20fill:%20%23306af1;%20}%20.st2%20{%20fill:%20%235ce5cf;%20}%20%3c/style%3e%3c/defs%3e%3cg%3e%3cpath%20class='st0'%20d='M55,10.5h9v3h-9v9h12V7.5h-12v3ZM64,19.5h-6v-3h6v3Z'/%3e%3cpolygon%20class='st0'%20points='69%2016.5%2078%2016.5%2078%2019.5%2069%2019.5%2069%2022.5%2081%2022.5%2081%2013.5%2072%2013.5%2072%2010.5%2081%2010.5%2081%207.5%2069%207.5%2069%2016.5'/%3e%3cpolygon%20class='st0'%20points='95%2010.5%2095%207.5%2083%207.5%2083%2022.5%2095%2022.5%2095%2019.5%2086%2019.5%2086%2016.5%2095%2016.5%2095%2013.5%2086%2013.5%2086%2010.5%2095%2010.5'/%3e%3cpath%20class='st0'%20d='M40,1.5v21h11.6l1.4-1.4v-7.6h0c0,0-1.4-1.5-1.4-1.5l1.4-1.4V2.9l-1.4-1.4h-11.6ZM50,19.5h-7v-6h7v6ZM50,10.5h-7v-6h7v6Z'/%3e%3c/g%3e%3cpath%20class='st1'%20d='M23.1,24L14.7,4.8l-4.9,11.2h3.8l-1.8,4H3.3L12.1,0H2C.9,0,0,.9,0,2v20c0,1.1.9,2,2,2h21.1Z'/%3e%3cpath%20class='st2'%20d='M34,0h-16.8l10.6,24h6.2c1.1,0,2-.9,2-2V2C36,.9,35.1,0,34,0ZM32.5,20h-4V4h4v16Z'/%3e%3c/svg%3e)
%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%230080ff;%20}%20%3c/style%3e%3c/defs%3e%3cpath%20class='st0'%20d='M16.2,11.1c.4.5.4,1.2,0,1.8l-4.7,7.1h-3.8l5.3-8L7.6,4h3.8l4.7,7.1Z'/%3e%3c/svg%3e)
