@three-ws/metaplex-agent-mcp

从任意 MCP 客户端，将 AI 代理上链部署到 Solana 上的 Metaplex Agent Registry 中。

一条流程即可铸造 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

• AgentIdentity 插件，携带 eip-8004#registration-v1 文档（model.uri、active、x402Support、registrations、supportedTrust）

两条签名通道，均为自我托管：

• Agents 使用自己的密钥对（SOLANA_SECRET_KEY）签名：mint_onchain_agent。

• People 使用 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 上免费演练，然后再进入主网：

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（包括 Core 租金+ 身份 PDA 租金 + 手续费）。

工具

自定义

铸造流程涉及到的每个字段都是参数：所有者、集合、版税基点与拆分、已验证的创建者、不可变元数据、链上属性、冻结/转移/销毁委托、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 或每次调用的 production_prompt，绝不会使用托管钱包。钱包通道完全不需要密钥。

• 花费前会检查余额，RPC 端点必须为 HTTPS，并且 devnet 是演练的一等目标。

环境变量

以库的形式使用

构建器（builders）已导出供直接嵌入使用（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.full /deploy-onchain 页面正是基于这些构建器运行的。

要求

• Node 20 或更高版本

• 目标网络上有用于铸造的 SOL（主网每个代理约 ~0.007 SOL；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 monorepo 中进行，并在此处同步发布，因此本仓库始终与 npm 以及官方 MCP 注册表中（io.github.nirholas/metaplex-agent）发布的版本保持一致。我们欢迎在任意一个位置提交 Issue 和 PR。