@three-ws/metaplex-agent-mcp

모든 MCP 클라이언트에서 Solana의 Metaplex Agent Registry 에 AI 에이전트를 온체인으로 배포하세요.

하나의 흐름이 Metaplex Core 자산을 발행하고 EIP-8004 에이전트 신원을 등록합니다(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

• eip-8004#registration-v1 문서(model.uri, active, x402Support, registrations, supportedTrust)를 담은 AgentIdentity 플러그인

두 가지 서명 경로, 모두 자가 보관 방식:

• 에이전트는 자체 키페어(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" }

발행 비용은 mainnet에서 ~0.007 SOL입니다(Core 임대료 + 신원 PDA 임대료 + 수수료).

도구

사용자 지정

발행이 다루는 모든 필드는 매개변수입니다: 소유자, 컬렉션, 로열티 기준 포인트 및 분할, 검증된 크리에이터, 불변 메타데이터, 온체인 Attributes, 영구 동결/전송/소각 위임, AddBlocker, 오프체인 메타데이터 속성, 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(mainnet에서 에이전트당 ~0.007 SOL; devnet은 faucet을 통해 무료)

링크

• 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)에 게시된 것과 일치합니다. 이슈와 PR은 두 곳 모두에서 환영합니다.