printr

@printr/mcp

适用于 Printr 的 MCP 服务——这是一个面向持有者打造的跨链代币发行平台。可让 AI Agent 在 EVM 链和 Solana 上发行、质押并完成代币毕业。

无需 API 密钥，开箱即用。

📖 文档

配置

添加到 MCP 客户端配置中（Claude Desktop、Cursor 等）：

{
    "mcpServers": {
        "printr": {
            "command": "npx",
            "args": ["-y", "@printr/mcp@latest"]
        }
    }
}

或使用 bunx：

{
    "mcpServers": {
        "printr": {
            "command": "bunx",
            "args": ["@printr/mcp@latest"]
        }
    }
}

技能（可选，与上述 MCP 配置互为补充）

除了 MCP 配置之外，还可以安装 Printr 技能，为 Agent 提供内置指导，说明何时以及如何使用这些工具。兼容 Claude Code、Cursor、Codex、OpenCode 以及 50 多种其他运行环境。

npx skills add PrintrFi/printr-mcp

预览但不安装：

npx skills add PrintrFi/printr-mcp --list

技能会从 packages/cli/skills/printr/SKILL.md 自动发现。完整工具列表和行为提示请参阅技能定义。

可选功能

自动生成代币图片

设置 OPENROUTER_API_KEY 后，如果创建代币时未提供图片，Agent 就会自动生成图片。此时还会提供 printr_generate_image 工具，以便单独生成图片。

"env": {
    "OPENROUTER_API_KEY": "<your-openrouter-key>"
}

允许 Agent 自主签署交易

默认情况下，创建代币时会返回未签名的交易，你可以通过浏览器钱包签署，或在每次调用时传入私钥。如果希望 Agent 在不提示的情况下签署并提交交易，请设置默认密钥：

"env": {
    "EVM_WALLET_PRIVATE_KEY": "<hex-private-key>",
    "SVM_WALLET_PRIVATE_KEY": "<base58-keypair-secret>"
}

不要将私钥放入共享配置中。尽可能使用环境级密钥。

工具

工具	说明
printr_quote	获取代币创建的成本估算
printr_create_token	生成未签名的代币创建交易负载
printr_launch_token	一次调用即可创建并签署代币
printr_get_token	按 ID 或地址查询代币详情
printr_get_deployments	检查目标链上的部署状态
printr_sign_and_submit_evm	签署并提交 EVM 交易负载
printr_sign_and_submit_svm	签署并提交 Solana 交易负载
printr_open_web_signer	启动浏览器签名会话（MetaMask / Phantom）
printr_generate_image	通过 OpenRouter 生成代币头像（需要 OPENROUTER_API_KEY）

完整工具列表（包括钱包、余额、转账、费用和质押工具）请参阅 packages/cli/skills/printr/SKILL.md。

环境变量

变量	描述
PRINTR_API_KEY	合作伙伴 API 密钥。默认使用公开的 AI 集成密钥。
OPENROUTER_API_KEY	启用自动图像生成和 printr_generate_image 工具
OPENROUTER_IMAGE_MODEL	覆盖图像模型（默认值：google/gemini-2.5-flash-image）
EVM_WALLET_PRIVATE_KEY	用于自主签名的默认 EVM 私钥
SVM_WALLET_PRIVATE_KEY	用于自主签名的默认 Solana 密钥对秘密
PRINTR_DEPLOYMENT_PASSWORD	用于加密部署钱包的主密码（至少 16 个字符）。调用 printr_fund_deployment_wallet 时必需。使用以下命令生成：openssl rand -base64 32

开发 / 自托管

变量	描述
PRINTR_API_BASE_URL	覆盖 API 基础 URL（默认值：https://api-preview.printr.money）
PRINTR_APP_URL	覆盖应用 URL（默认值：https://app.printr.money）

开发

这是一个包含三个软件包的 monorepo：

• @printr/sdk — 核心 TypeScript SDK（与框架无关）
• @printr/mcp — 封装 SDK 的 MCP 服务
• @printr/cli — 用于设置和配置的 CLI

bun install
bun dev          # Run MCP server with hot reload
bun test         # Run all tests
bun run check    # typecheck + lint + test

软件包专用命令

# SDK
bun run --cwd packages/sdk test
bun run --cwd packages/sdk build

# MCP
bun run --cwd packages/mcp test
bun run --cwd packages/mcp build

直接使用 SDK

使用 createPrintrClient 和 buildToken：

import { createPrintrClient, buildToken } from '@printr/sdk';

const client = createPrintrClient({
  apiKey: process.env.PRINTR_API_KEY,
});

const result = await buildToken({
  creator_accounts: ['eip155:8453:0x...'],
  name: 'My Token',
  symbol: 'TKN',
  description: 'A cool token',
  chains: ['eip155:8453'],
  initial_buy: { spend_usd: 10 },
}, client);