使用说明
BAGSX MCP服务器v2.0
🤖 “嘿，克劳德，用1索尔换BAGSX”
第一个让Claude为您交易Solana代币的MCP服务器
🚀 快速开始 • 💰 购买$BAGSX • 📖 文档 • 🎥 演示
🎥 演示
马上就来： GIF显示现场克劳德+BAGSX互动
You: "What can I claim for wallet 7xK2..."
Claude: You have 0.57 SOL claimable across 2 tokens. Want me to generate the claim transactions?
You: "Yes"
Claude: Done. Copy this unsigned transaction to Phantom and sign it.
零监护权。你总是拿着钥匙。
💎 $袋子和代币
| 🪙 令牌 | 📍 铸币厂地址 | 🛒 立即购买 |
|---|---|---|
| $袋x | BA6ggscnXVgfENwPGk9CXeEqKR67T9z6n64G5ue5BAGS |
袋子.fm/BAGSX |
$BAGSX上的每笔交易都会产生创作者费用→ 重新投资于开发+黑客马拉松奖。
🔥 为什么选择BAGSX？
| BAGSX之前 | 使用BAGSX |
|---|---|
| ❌ 将地址复制粘贴到DEX | ✅ 克劳德，用1索尔换BAGSX |
| ❌ 手动检查费用报销 | ✅ “我可以在所有代币中索赔什么？” |
| ❌ 复杂的代币发行流程 | ✅ “启动一个名为DEMO的令牌” |
| ❌ 在代码中管理费用拆分 | ✅ “用这个钱包平分费用” |
这就是DeFi应该有的感觉。 与你的人工智能对话，把事情做好。
✨ 特性
BAGSX是一个 模型上下文协议（MCP）服务器 连接 克劳德 到 袋装API --在Solana上实现人工智能驱动的交易、代币发行和费用管理。
用简单的英语与克劳德交谈：
- 💰 获取掉期报价 执行带有滑点保护的交易
- 🚀 启动代币 具有自动元数据和绑定曲线
- 💸 索赔创建者费用 从您推出的代币中
- 📊 查看分析 关于创作者、费用和索赔事件
- ⚙️ 配置费用分摊 拥有多个钱包
专为价值400万美元的Bags黑客马拉松而打造 -19个真正的API工具
特性
| 特性 | 描述 |
|---|---|
| 🛠️ 19个真正的工具 | 每个工具都映射到一个实际的Bags API端点-没有伪造数据 |
| 💱 交易 | 获取报价，执行带有自动滑点保护的掉期交易 |
| 🚀 代币发行 | 准备元数据+在2个命令中创建绑定曲线标记 |
| 💸 费用管理 | 索赔费用、配置拆分、转移管理员——所有这些都是通过聊天实现的 |
| 🔐 零保管 | 所有交易都是未指定的——您在钱包中登录 |
| ⚡ 快 | 直接调用API，无链上模拟开销 |
安全模型
BAGSX使用未签名的交易 --您的私钥永远不会离开您的钱包：
- 你让克劳德交易/索赔等
- BAGSX生成未签名的交易
- 您将交易复制到您的钱包（Phantom/Solflare）
- 您签署并提交自己
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Claude + MCP │ → │ Unsigned TX │ → │ Your Wallet │
│ (analysis) │ │ (base64 blob) │ │ (you sign) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
零保管风险。 我们永远看不到你的私钥。
安装
先决条件
快速安装
# Clone the repo
git clone https://github.com/Maaz-1997/bagsx-mcp.git
cd bagsx-mcp
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your Bags API key
# Build
npm run build
添加到克劳德桌面
编辑您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在Mac或 %APPDATA%/Claude/claude_desktop_config.json 在Windows上）：
{
"mcpServers": {
"bagsx": {
"command": "node",
"args": ["/path/to/bagsx-mcp/dist/index.js"],
"env": {
"BAGS_API_KEY": "your_api_key_here"
}
}
}
}
重新启动克劳德桌面。您将在MCP服务器列表中看到“bagsx”。
用法
连接后，只需与Claude交谈：
获取掉期报价
"Get a quote for swapping 0.5 SOL to BAGSX"
"What's the price to swap 1 SOL to this token?"
"Quote me a swap from SOL to BA6ggscnXVgfENwPGk9CXeEqKR67T9z6n64G5ue5BAGS"
执行交易
"Execute that swap with my wallet 7xK2..."
"Create a swap transaction for wallet ABC123..."
启动代币
"Prepare a token called DEMO with symbol DMO"
"Create token metadata with description 'My awesome project'"
索赔创建者费用
"What fees can I claim for wallet 7xK2...?"
"Show my claimable positions"
"Generate claim transactions for this token"
管理费用分摊
"Look up fee wallet for Twitter user @username"
"Create fee share config splitting 50/50 between two wallets"
"List tokens where I'm admin"
查看分析
"Show creators for token XYZ"
"What are the lifetime fees for BAGSX?"
"Get claim stats for this token mint"
工具
💰 交易（2个工具）
| 工具 | 说明 |
|---|---|
bags_quote |
获取具有价格影响和滑点的掉期报价。支持自动或手动滑动。 |
bags_swap |
根据报价创建未签名的掉期交易。你在钱包里签名。 |
🚀 代币发行（2个工具）
| 工具 | 说明 |
|---|---|
bags_launch_prepare |
创建令牌元数据（名称、符号、图像、社交）。返回薄荷地址。 |
bags_launch_execute |
创建绑定曲线启动事务。您签署部署。 |
📊 分析（4个工具）
| 工具 | 说明 |
|---|---|
bags_creators |
获取令牌的创建者信息和版税设置。 |
bags_lifetime_fees |
代币自推出以来产生的总费用。 |
bags_claim_stats |
谁申请了费用，费用多少（按钱包分类）。 |
bags_claim_events |
带有时间戳和签名的历史索赔事件。 |
💸 费用报销（2个工具）
| 工具 | 说明 |
|---|---|
bags_claimable |
检查钱包（所有代币）的可申报头寸。 |
bags_claim_fees |
生成未签名的交易以申请费用。你签 |
⚙️ 费用分摊配置（5个工具）
| 工具 | 说明 |
|---|---|
bags_fee_wallet |
在费用共享钱包中查找社交用户名（推特等）。 |
bags_fee_config |
使用多个索赔人和拆分人创建费用分成配置。 |
bags_admin_list |
列出钱包具有管理员权限的令牌。 |
bags_admin_update |
更新费用分成（仅限管理员）。 |
bags_admin_transfer |
将管理员权限转移到另一个钱包。 |
🏊 状态/池（2个工具）
| 工具 | 说明 |
|---|---|
bags_pools |
列出所有Bags池（可选择仅过滤为已迁移）。 |
bags_pool_info |
通过代币造币厂地址获取池详细信息。 |
🤝 合作伙伴（2个工具）
| 工具 | 说明 |
|---|---|
bags_partner_stats |
查看已索赔和未索赔的合作伙伴费用。 |
bags_partner_claim |
生成未签名的交易以申请合作伙伴费用。 |
使用示例
获取掉期报价
You: "Get a quote for swapping 0.5 SOL to the BAGSX token"
Claude: [Uses bags_quote tool]
Quote details:
- Input: 0.5 SOL (500000000 lamports)
- Output: ~2,547,510,849,175,944 BAGSX
- Price Impact: 0.002%
- Slippage: 100 bps (1%)
- Request ID: 64aa5700-1f3b-4127-a191-5311ab0274aa
Use bags_swap with this request ID to execute the trade.
执行交换
You: "Execute that swap with my wallet 7xK2..."
Claude: [Uses bags_swap tool]
Unsigned transaction ready:
- Transaction: AQAAAA...
- Block Height: 234567890
- Priority Fee: 5000 lamports
To complete: Copy to Phantom → Sign → Submit
启动令牌
You: "Prepare a token called DEMO with symbol DMO"
Claude: [Uses bags_launch_prepare tool]
Token info created:
- Mint: 9xYz123...
- Metadata URI: ipfs://...
- Status: Ready
Use bags_launch_execute to deploy the bonding curve.
申请创作者费用
You: "What fees can I claim for wallet 7xK2...?"
Claude: [Uses bags_claimable tool]
Claimable positions:
| Token | Amount |
|-------|--------|
| BAGSX | 0.42 SOL |
| DEMO | 0.15 SOL |
Total: 0.57 SOL
Shall I generate claim transactions?
配置
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
BAGS_API_KEY |
是 | 您的行李API密钥来自dev.Bags.fm |
获取API密钥
- 首选 dev.bags.fm
- 注册/登录
- 创建新的API密钥
- 添加到您的
.env文件
分类
该项目已提交至 包黑客马拉松2026 下：
- ✅ 克劳德技能 --用于Claude集成的MCP服务器
- ✅ 袋API -与公共Bags.fm API完全集成
- ✅ AI代理 --通过自然语言实现人工智能交易
发展
# Run in development mode
npm run dev
# Build for production
npm run build
# Start production server
npm start
项目结构
bagsx-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── config.ts # Configuration management
│ ├── lib/
│ │ └── bags-client-new.ts # Bags API client (19 methods)
│ └── tools/
│ ├── definitions-new.ts # Tool schemas (19 tools)
│ └── handlers-new.ts # Tool implementations
├── package.json
├── tsconfig.json
└── README.md
安全
- 🔒 从不需要私钥 --所有交易均未签名
- 🔒 API密钥在环境中 --没有硬编码或暴露给Claude
- 🔒 你签了所有东西 --完全控制提交的内容
- 🔒 开源 --自己审核代码
路线图
- [x] 核心MCP服务器与真正的API集成
- [x] 19种工作工具（交易、发布、费用、分析）
- [x] 零托管安全模式
- [x] $BAGSX代币发布
- []随着Bags API的扩展而进行的额外分析
- []实时价格反馈（如果可用）
链接
- Bags.fm: https://bags.fm
- 行李API单据: https://docs.bags.fm
- 包黑客马拉松: https://bags.fm/hackathon
- MCP规范: https://modelcontextprotocol.io
许可证
MIT许可证——见 许可证
专为2026年耗资400万美元的Bags黑客马拉松而打造
