@three-ws/metaplex-agent-mcp

任意のMCPクライアントから、Solana上の**Metaplex Agent Registry**にAIエージェントをオンチェーンでデプロイします。

1つのフローでMetaplex Coreアセットをミントし、そのEIP-8004エージェントIDを登録します（Solanaの1232バイト制限に収まる場合は単一のアトミックトランザクション、それ以外の場合は作成と登録を順に実行します。これはGenesis 333が着地した方法とまったく同じです）。これにより、エージェントは独自の組み込みウォレット、レピュテーションサーフェス、エクスプローラーページを備えてmetaplex.com/agentsに表示されます。デフォルトの出力は、three.ws Genesis 333ミントの正確な形状を再現し、ライブアセットとバイト単位で検証されています：

• アセットメタデータは自己完結型の data:application/json;base64 URI（name、image、animation_url GLB）

• Royaltiesプラグイン（所有者に5%）、VerifiedCreators（署名ウォレット）、ImmutableMetadata

• AgentIdentityプラグインは eip-8004#registration-v1 ドキュメント（model.uri、active、x402Support、registrations、supportedTrust）を保持

2つの署名レーンがあり、どちらも自己管理型です：

• エージェントは自分のキーペア（SOLANA_SECRET_KEY）で署名します：mint_onchain_agent。

• 人はPhantom、Solflare、Backpack、Ledger、または任意のSolanaウォレットで署名します：prepare_agent_mintがトランザクションを構築し、ウォレットが署名し、send_signed_transactionがブロードキャストします。キーがサーバーに触れることはありません。

何もモックされていません：実際のMetaplexプログラム、実際のSolana、そして無料のエンドツーエンドリハーサルのためのdevnetサポート。

Install

npm install -g @three-ws/metaplex-agent-mcp
# or run ad hoc
npx -y @three-ws/metaplex-agent-mcp

Related MCP server: AgentWallet MCP Server

Setup

Claude Code:

claude mcp add metaplex-agent -e SOLANA_SECRET_KEY=<base58> -- npx -y @three-ws/metaplex-agent-mcp

Cursor / 任意のMCPクライアント（mcp.json）：

{
	"mcpServers": {
		"metaplex-agent": {
			"command": "npx",
			"args": ["-y", "@three-ws/metaplex-agent-mcp"],
			"env": { "SOLANA_SECRET_KEY": "<base58 secret key>" }
		}
	}
}

SOLANA_SECRET_KEYはオプションです：すべての読み取りツールとPhantom/Solflareフロー全体は、それがなくても動作します。

Quick start

devnetで無料でリハーサルしてから、mainnetに進みます：

1. agent_wallet {}                                → confirm the signer is funded
2. mint_onchain_agent { name: "Astra", description: "…",
     image: "https://…png", model_url: "https://…glb",
     x402_support: true, network: "devnet" }      → preview (nothing broadcast)
3. …same call with confirm: true                  → minted + registered, links returned
4. get_onchain_agent { asset: "<returned asset>", network: "devnet" }

ミントはmainnetで約0.007 SOLかかります（Coreレント + ID PDAレント + 手数料）。

Tools

Customization

ミントが触れるすべてのフィールドはパラメータです：所有者、コレクション、ロイヤリティのベーシスポイントと分割、検証済みクリエイター、不変メタデータ、オンチェーン属性、恒久的なフリーズ/転送/バーン委任、AddBlocker、オフチェーンメタデータ属性、external_url、サービス、トラストモデル、登録エントリ、そして自分でホストするドキュメントのための完全なmetadata_uri / registration_uriオーバーライド。デフォルトはGenesis 333の値なので、name、description、image、model_urlだけで呼び出すと、元のものと形状が区別できないアセットが生成されます。

Safety

• mint_onchain_agentとregister_agent_identityは**confirm: trueの場合のみ**ブロードキャストします（REQUIRE_CONFIRM=falseを設定するとオプトアウト）。プレビューは無料です。

• キーはあなたのものです：SOLANA_SECRET_KEYまたは呼び出しごとのsecret。カストディアルウォレットは決して使用しません。ウォレットレーンはキーを一切必要としません。

• 支出前に残高を確認し、RPCエンドポイントはHTTPSである必要があり、devnetはリハーサルの第一級のターゲットです。

Environment variables

Library use

ビルダーは直接埋め込むためにエクスポートされています（Webアプリ、スクリプト）：

import { buildAgentMint, sendAgentMint, buildUmi, toBase58Signature } from '@three-ws/metaplex-agent-mcp/lib';

const umi = buildUmi({ network: 'devnet', secret: process.env.SOLANA_SECRET_KEY });
const mint = buildAgentMint(umi, {
	network: 'devnet',
	creator: umi.identity.publicKey.toString(),
	name: 'Astra',
	description: 'An autonomous 3D agent',
	image: 'https://example.com/astra.png',
	modelUrl: 'https://example.com/astra.glb',
	x402Support: true,
});
const { signatures, atomic } = await sendAgentMint(umi, mint, { toBase58Signature });

登録およびメタデータビルダーは、@three-ws/metaplex-agent-mcp/lib/registrationから単独でインポート可能（依存関係なし、ブラウザセーフ）であり、トランザクションビルダーは@three-ws/metaplex-agent-mcp/lib/mintからインポート可能です。three.wsの/deploy-onchainページはまさにこれらで動作します。

Requirements

• Node 20+

• ミント用のターゲットネットワーク上のSOL（mainnetではエージェントあたり約0.007 SOL、devnetはフォーセット経由で無料）

Links

• three.ws: https://three.ws

• ライブデプロイメントフィード: https://three.ws/deployments

• Metaplex Agent Registry: https://www.metaplex.com/agents

• Metaplexドキュメント: https://www.metaplex.com/docs/agents

• ソース: https://github.com/nirholas/three.ws/tree/main/packages/metaplex-agent-mcp

About this repository

これは@three-ws/metaplex-agent-mcpのスタンドアロンのホームです。開発はthree.ws monorepoで行われ、リリースはここにミラーリングされるため、このリポジトリはnpmおよび公式MCPレジストリ（io.github.nirholas/metaplex-agent）に公開されているものと常に一致します。問題やPRはどちらの場所でも歓迎します。