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. 02ERC721とERC1155への対応
  3. 03ファイルまたはbase64からアセット作成
  4. 04アセットの一覧、検索、ページ分け
  5. 05画像、動画、音声、文書に対応

活用シーン

  1. 01NFTコレクションの作成
  2. 02メディアファイルからアセットをミント
  3. 03複数コレクション内のアセット検索
  4. 04ERC1155アセットの発行数管理

MCP 対応

コレクションの一覧表示・作成と、アセットの一覧表示・作成を行う4つのNFT管理ツールをMCPクライアントに公開します。操作には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 Server

🚀 クイックインストール

VS Code にインストール VS Code Insiders にインストール Cursor にインストール Goose にインストール LM Studio にインストール

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 にインストール

または手動でインストールします。

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
ボタンをクリックしてインストールします。

LM Studio に Uranium MCP サーバーを追加

または手動でインストールします。

右側のサイドバーで 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 の 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):アセットをミントするコレクションの ID
    • title (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
開発
ソースからのビルド
  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 キーが機能しない:API キーが有効であり、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
ライセンス

todo

サポート

問題や質問がある場合:

  • uranium.pro でサポートにお問い合わせください

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。