@three-ws/metaplex-agent-mcp

Развертывайте AI-агентов в Metaplex Agent Registry в Solana из любого MCP-клиента.

Один поток чеканит Metaplex Core asset и регистрирует его EIP-8004 agent identity (одна атомарная транзакция, когда она укладывается в лимит Solana в 1232 байта, иначе create + register последовательно — именно так легли Genesis 333), так что агент появляется на metaplex.com/agents со своим встроенным кошельком, поверхностью репутации и страницами в обозревателе. Вывод по умолчанию воспроизводит точную форму минтов three.ws Genesis 333, проверенную байт-в-байт по живым активам:

• метаданные актива как самодостаточный URI data:application/json;base64 (name, image, animation_url GLB)

• плагин Royalties (5% владельцу), VerifiedCreators (подписывающий кошелёк), ImmutableMetadata

• плагин AgentIdentity, несущий документ eip-8004#registration-v1 (model.uri, active, x402Support, registrations, supportedTrust)

Два пути подписания, оба с самостоятельным хранением ключей:

• Агенты подписывают своим собственным ключом (SOLANA_SECRET_KEY): mint_onchain_agent.

• Люди подписывают через Phantom, Solflare, Backpack, Ledger или любой кошелёк Solana: prepare_agent_mint собирает транзакцию, кошелёк её подписывает, send_signed_transaction отправляет её в сеть. Никакой ключ никогда не касается сервера.

Ничего не имитируется: реальные программы Metaplex, реальная Solana, а devnet поддерживает бесплатную сквозную репетицию.

Установка

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

Настройка

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 работают без него.

Быстрый старт

Отрепетируйте на 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" }

Минт стоит ~0.007 SOL на mainnet (аренда Core + аренда identity PDA + комиссии).

Инструменты

Настройка

Каждое поле, которого касается минт, является параметром: владелец, коллекция, базовые точки роялти и их распределение, верифицированный создатель, неизменяемые метаданные, атрибуты on-chain, постоянные делегаты заморозки/передачи/сжигания, AddBlocker, атрибуты метаданных off-chain, external_url, сервисы, модели доверия, записи регистрации и полные переопределения metadata_uri / registration_uri для документов, которые вы размещаете сами. Значения по умолчанию — значения Genesis 333, так что вызов только с name, description, image и model_url даёт актив, неотличимый по форме от оригиналов.

Безопасность

• mint_onchain_agent и register_agent_identity отправляют в сеть только с confirm: true (установите REQUIRE_CONFIRM=false, чтобы отказаться); предпросмотры ничего не стоят.

• Ключи остаются вашими: SOLANA_SECRET_KEY или secret на вызов, никогда не кастодиальный кошелёк. Путь кошелька вообще не требует ключа.

• Балансы проверяются перед тратой, RPC-эндпоинты должны быть HTTPS, а devnet — полноценная цель для репетиции.

Переменные окружения

Использование как библиотеки

Сборщики экспортируются для прямого встраивания (веб-приложения, скрипты):

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 работает именно на них.

Требования

• Node 20+

• SOL в целевой сети для минта (~0.007 SOL на агента на mainnet; devnet бесплатен через кран)

Ссылки

• 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

Об этом репозитории

Это отдельный дом @three-ws/metaplex-agent-mcp. Разработка ведётся в монорепозитории three.ws, а релизы зеркалируются сюда, так что этот репозиторий всегда соответствует тому, что опубликовано на npm и в официальном реестре MCP (io.github.nirholas/metaplex-agent). Issues и PR приветствуются в любом из мест.