Uranium Mcp について
Uranium Mcpは、portal.uranium.proでNFTコレクションとアセットを作成・管理するMCPサーバーです。ERC721とERC1155に対応し、LLMクライアントからローカルファイルまたはbase64データを使ってアセットを作成できます。
主な機能
- 01コレクションの一覧表示と作成
- 02ERC721とERC1155への対応
- 03ファイルまたはbase64からアセット作成
- 04アセットの一覧、検索、ページ分け
- 05画像、動画、音声、文書に対応
活用シーン
- 01NFTコレクションの作成
- 02メディアファイルからアセットをミント
- 03複数コレクション内のアセット検索
- 04ERC1155アセットの発行数管理
MCP 対応
コレクションの一覧表示・作成と、アセットの一覧表示・作成を行う4つのNFT管理ツールをMCPクライアントに公開します。操作にはUranium APIを使用し、Uranium APIキーが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
4掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
Uranium MCP Server
🚀 クイックインストール
portal.uranium.pro と連携し、NFT コレクションとアセットを作成・管理するための Model Context Protocol(MCP)サーバーです。このサーバーにより、LLM はシンプルで構造化されたインターフェースを通じてブロックチェーン上の 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」をクリックします。
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
#### ボタンをクリックしてインストールします:または手動でインストールします:
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 の GitHub Copilot エージェントで Uranium MCP サーバーを使用できるようになります。
Windsurf
Windsurf MCP のドキュメントに従ってください。API キーを指定して、上記の標準設定を使用します。
設定
環境変数
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"
// 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
設定では、npx uranium-tools-mcp@latest の代わりに uranium-tools-mcp を使用してください。
ツール
この MCP サーバーでは、NFT 管理用の主なツールを 4 つ提供しています:
コレクション管理
list_collections
- 説明:ユーザーのすべてのコレクション(個人用、共通、外部)を一覧表示します
- パラメーター:なし
create_collection
- 説明:新しい NFT コレクションを作成します
- パラメーター:
name(string、必須):コレクション名(3~30 文字。英字、数字、[_.-] 記号を使用)[最小文字数:3、最大文字数:30]symbol(string、必須):コレクションのシンボル(3~30 文字。英字、数字、アンダースコアを使用)[最小文字数:3、最大文字数:30]type(string、列挙値:ERC721、ERC1155、必須):コレクションの種類:ERC721(単一 NFT)または ERC1155(マルチトークン)
アセット管理
list_assets
- 説明:コレクション、検索、ページネーションによる任意の絞り込みを指定して、アセットを一覧表示します
- パラメーター:
contractId(string、任意):コレクション ID でアセットを絞り込みますpage(number、任意):ページ番号(デフォルト:1)[最小値:1、デフォルト:1]pageSize(number、任意):1 ページあたりのアセット数(デフォルト:20、最大:100)[最小値:1、最大値:100、デフォルト:20]sortBy(string、任意):並べ替え対象のフィールド(デフォルト:createdAt)[デフォルト:"createdAt"]order(string、列挙値:asc、desc、任意):並べ替え順(デフォルト:asc)[デフォルト:"asc"]quickFilter(string、任意):タイトルでアセットを絞り込む検索テキスト
create_asset
- 説明:ローカルファイルまたは base64 データから新しい NFT アセットを作成します
- パラメーター:
filePath(string, optional):メディアファイルの絶対パス(ローカルファイルの場合)fileData(string, optional):ファイルデータを base64 でエンコードしたもの(Claude Desktop の場合)fileName(string, optional):元のファイル名(fileData を使用する場合は必須)mimeType(string, optional):ファイルの MIME タイプ(fileData を使用する場合は必須。例:'image/png')contractId(string, required):アセットをミントするコレクションの IDtitle(string, required):アセットのタイトル(3~120 文字)[最小文字数:3、最大文字数:120]description(string, optional):アセットの説明(任意、最大 255 文字)[最大文字数:255]location(string, optional):アセットを作成した場所(任意、最大 100 文字)[最大文字数:100]editions(number, optional):エディション数(ERC1155 コレクションのみ、1~1000)[最小値:1、最大値:1000]shareWithCommunity(boolean, optional):アセットをコミュニティから見つけられるようにします(任意、デフォルト: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 キーが機能しない:API キーが有効であり、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
ライセンス
todo
サポート
問題や質問がある場合:
- uranium.pro でサポートにお問い合わせください
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。