Crossmint HR 空投 MCP

一个模型上下文协议 (MCP) 服务器，旨在帮助企业 HR 团队向员工空投 Solana 代币。该项目提供了一种高效的方式将代币分发到员工钱包地址，并支持基于角色的分配和自动电子邮件通知。

功能

• 钱包管理: 连接 Solana 钱包或 Crossmint 钱包以签名和资助交易
• 代币创建: 在 Solana 区块链上创建自定义代币
• 流动性管理: 通过 Raydium AMM 为新代币增加流动性
• 托管钱包生成: 为员工创建 Crossmint 托管钱包
• CSV 导入: 上传包含姓名、电子邮件和角色信息的员工数据
• 基于角色的分配: 根据员工角色分配代币
• Gas 费用估算: 在空投前计算交易费用
• 压缩空投: 使用 ZK light 协议进行高效的代币分发
• 电子邮件通知: 向员工发送访问其代币的说明

前提条件

• Node.js (v16+)
• pnpm 包管理器
• 带有 SOL 的 Solana 钱包，用于支付交易费用
• Crossmint API 密钥，用于创建托管钱包
• Resend API 密钥，用于发送电子邮件
• Helius API 密钥，用于压缩交易（可选）

安装

1. 克隆和设置

git clone https://github.com/monostate/Employees-Airdrop-Rewards-MCP.git
cd crossmint-hr-airdrop-mcp
./setup.sh

设置脚本将执行以下操作：

• 安装依赖项
• 克隆所需的存储库
• 创建一个 .env 文件模板
• 构建项目

2. 配置环境变量

使用您的 API 密钥和配置编辑 .env 文件：

# Crossmint API 密钥 (创建托管钱包必需)
CROSSMINT_API_KEY=your_crossmint_api_key

# Crossmint 电子邮件 (钱包操作必需)
CROSSMINT_EMAIL=your_email@example.com

# Resend API 密钥 (发送电子邮件必需)
RESEND_API_KEY=your_resend_api_key

# Helius API 密钥 (可选，用于压缩交易)
HELIUS_API_KEY=your_helius_api_key

# Solana RPC URL (可选，默认为 mainnet-beta)
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

3. 安装到 Claude Desktop

pnpm install-mcp

这会将 MCP 服务器安装到 Claude Desktop。 您需要重新启动 Claude Desktop 才能加载新的 MCP 服务器。

使用指南

配置完成后，您可以通过向 Claude Desktop 提供如下指令来使用 HR 空投 MCP 服务器：

1. 连接 Solana 钱包或 Crossmint 钱包
2. 创建用于员工奖励的代币
3. 为代币增加流动性
4. 为员工生成托管钱包
5. 上传包含员工角色的 CSV 文件
6. 计算代币分配
7. 计算 gas 费用
8. 执行空投
9. 发送通知邮件

可用工具

• connect_wallet: 连接 Solana 钱包
• connect_crossmint_wallet: 连接 Crossmint 钱包
• check_balance: 检查钱包 SOL 余额
• create_token: 创建新代币
• add_liquidity: 为代币增加流动性
• generate_wallets: 为员工创建托管钱包
• upload_csv: 处理来自 CSV 的员工数据
• calculate_amounts: 计算代币分配金额
• calculate_fees: 计算空投的 gas 费用
• start_airdrop: 执行代币空投
• send_emails: 向员工发送通知
• get_state: 检查空投过程的当前状态

CSV 格式

对于基于角色的代币分配，请准备一个包含以下列的 CSV 文件：

name,email,role
John Doe,john@example.com,developer
Jane Smith,jane@example.com,manager

支持的角色：operational, developer, manager, VP, VIP

开发

要对项目进行更改：

1. 修改 src/ 中的 TypeScript 文件
2. 使用 pnpm build 重新构建
3. 如果需要，更新您的 Claude Desktop 配置

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 使用 模型上下文协议 构建
• 使用 @solana/web3.js 库
• 使用 Crossmint SDK 进行钱包管理
• 使用 GOAT SDK 进行 Solana 钱包集成