1ly MCP Server

@1ly/mcp-server

适用于 1ly.store 的 MCP 服务——让 AI Agent 能够使用加密货币发现、购买和销售 API。

概述

此 MCP 服务让 AI Agent 能够：

• 购买 — 搜索、发现并支付 API／资源费用，自动完成加密货币支付（x402 协议）
• 销售 — 创建商店，列出付费 API 端点或资源，并收取款项
• 发行代币 — 在 Bags.fm 上创建和交易代币，并领取手续费分成

支持的网络： Solana（主网）、Base（主网）
支付货币： USDC 和 $1LY（仅限 Solana）

这是什么？

此 MCP 服务让 AI Agent（Claude、GPT、Cursor 等）能够：

• 在 1ly.store 上创建商店
• 使用 1ly 作为支付层，为你的 API／资源收款
• 创建付费链接，让任何兼容 x402 的 Agent 都能调用并自动付款
• 在 1ly 市场上列出付费链接，方便 Agent 即时发现
• 在 1ly.store 上搜索 API 和服务
• 获取定价、评价和使用情况的详情
• 安全地调用付费 API，并自动完成加密货币支付（x402 协议）
• 购买后留下评价（可选，但推荐）
• 在 Bags.fm 上发行代币、交易 Solana 代币并领取手续费

快速开始

钱包路径规则： 钱包文件必须位于你的主目录（推荐）或 /tmp 中。出于安全考虑，其他位置的路径将被拒绝。直接从终端运行时支持 ~/，并会将其展开为你的主目录。 重要： Claude Desktop 和 Cursor 的配置 JSON 不会展开 ~。在 JSON 配置文件中始终使用绝对路径（例如 /Users/yourname/.1ly/wallets/solana.json）。

1. 安装并运行

选项 A：原始钱包（默认）

# Solana wallet
ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" npx @1ly/mcp-server

# OR Base/EVM wallet
ONELY_WALLET_EVM_KEY="~/.1ly/wallets/evm.key" npx @1ly/mcp-server

# OR both wallets
ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" \
ONELY_WALLET_EVM_KEY="~/.1ly/wallets/evm.key" \
npx @1ly/mcp-server

选项 B：Coinbase Agentic Wallet（仅限 Base）

ONELY_WALLET_PROVIDER="coinbase" npx @1ly/mcp-server

使用 Agentic Wallet 时，不要传入原始私钥。
确保 Coinbase Agentic Wallet 应用正在运行且已通过身份验证。

如果你尚未安装 Agentic Wallet：

• 按照 Coinbase Agentic Wallet 文档操作：docs.cdp.coinbase.com/agentic-wallet/welcome
• 快速安装：

npx skills add coinbase/agentic-wallet-skills
npx awal show

选项 C：DCP Local（推荐用于安全签名）

# Start DCP locally
dcp init
npx @dcprotocol/server

# Run MCP (auto-detects DCP at localhost:8420)
npx @1ly/mcp-server

选项 D：DCP Remote（中继）

# Pairing outputs these values
DCP_VAULT_ID="vault_..." \
DCP_RELAY_URL="wss://relay.dcp.1ly.store" \
DCP_VAULT_HPKE_PUBLIC_KEY="base64..." \
npx @1ly/mcp-server

2. 验证设置

ONELY_WALLET_SOLANA_KEY="~/.1ly/wallets/solana.json" npx @1ly/mcp-server --self-test

配置

HTTP 模式（云端 MCP）

通过 HTTP 运行 MCP（用于云端托管或 mcp.1ly.store）：

# HTTP transport
MCP_TRANSPORT=http npx @1ly/mcp-server

# Custom host/port
MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=3000 npx @1ly/mcp-server

环境变量

仅付费调用需要钱包。免费搜索和详情查询无需钱包即可运行。 请使用以下其中一项：ONELY_WALLET_SOLANA_KEY、ONELY_WALLET_EVM_KEY 或 ONELY_WALLET_PROVIDER=coinbase。

Claude Desktop 配置

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "1ly": {
      "command": "npx",
      "args": ["@1ly/mcp-server"],
      "env": {
        "ONELY_WALLET_SOLANA_KEY": "/Users/yourname/.1ly/wallets/solana.json",
        "ONELY_BUDGET_PER_CALL": "1.00",
        "ONELY_BUDGET_DAILY": "50.00"
      }
    }
  }
}

注意： 将 /Users/yourname 替换为你的实际主目录。在 Linux 上使用 /home/yourname。在 Claude Desktop 配置中，~ 无效。

{
  "mcpServers": {
    "1ly": {
      "command": "npx",
      "args": ["@1ly/mcp-server"],
      "env": {
        "ONELY_WALLET_EVM_KEY": "/Users/yourname/.1ly/wallets/evm.key",
        "ONELY_BUDGET_PER_CALL": "1.00",
        "ONELY_BUDGET_DAILY": "50.00"
      }
    }
  }
}

Cursor 一键安装

Cursor 使用 .cursor/mcp.json。如果你更喜欢手动配置，请使用：

{
  "mcpServers": {
    "1ly": {
      "command": "npx",
      "args": ["@1ly/mcp-server"],
      "env": {
        "ONELY_WALLET_SOLANA_KEY": "/absolute/path/to/solana.json",
        "ONELY_BUDGET_PER_CALL": "1.00",
        "ONELY_BUDGET_DAILY": "50.00"
      }
    }
  }
}

{
  "mcpServers": {
    "1ly": {
      "command": "npx",
      "args": ["@1ly/mcp-server"],
      "env": {
        "ONELY_WALLET_SOLANA_KEY": "~/.1ly/wallets/solana.json",
        "ONELY_WALLET_EVM_KEY": "~/.1ly/wallets/evm.key",
        "ONELY_BUDGET_PER_CALL": "1.00",
        "ONELY_BUDGET_DAILY": "50.00"
      }
    }
  }
}

工具参考

买家工具

仅付费调用（1ly_call）需要钱包。搜索和详情查询无需钱包。

1ly_search

在 1ly.store 市场中搜索 API。

{
  "query": "weather api",
  "type": "api",
  "maxPrice": 0.10
}

返回：

{
  "ok": true,
  "data": {
    "results": [
      {
        "title": "Real-time Weather",
        "endpoint": "/api/link/joe/weather",
        "price": "$0.010000000000000000 USDC",
        "type": "api",
        "seller": "Joe's APIs",
        "stats": { "buyers": 150, "rating": "95%" }
      }
    ],
    "total": 42,
    "showing": 10
  }
}

1ly_get_details

获取特定 API 的详细信息。

{
  "endpoint": "joe/weather"
}

返回（示例）：

{
  "ok": true,
  "data": {
    "endpoint": "/api/link/joe/weather",
    "fullUrl": "https://1ly.store/api/link/joe/weather",
    "link": {
      "title": "Real-time Weather",
      "description": "Global weather data",
      "slug": "weather",
      "price": "0.010000000000000000",
      "currency": "USDC"
    },
    "paymentInfo": { "networks": ["solana", "base"] },
    "reviews": {
      "stats": { "total": 50, "positive": 48 },
      "recent": [{ "positive": true, "comment": "Fast!" }]
    }
  }
}

1ly_call

通过自动加密货币付款调用付费 API。

{
  "endpoint": "joe/weather",
  "method": "POST",
  "body": { "city": "NYC" }
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "data": {
      "temp": 72,
      "conditions": "sunny"
    },
    "_1ly": {
      "purchaseId": "abc123",
      "txHash": "tx_hash_here",
      "reviewUrl": "https://1ly.store/api/review/abc123",
      "reviewToken": "xyz789"
    }
  }
}

注意： _1ly 对象包含 1ly_review 所需的令牌。若要留下评价，请保存这些令牌。
对于免费 API，_1ly 可能为 { "note": "No payment required (free API)" }。

Agentic Wallet（仅限 Base）：

• 设置 ONELY_WALLET_PROVIDER=coinbase。
• 确保 Coinbase Agentic Wallet 已安装、正在运行并已完成身份验证。
• 无需本地私钥。

1ly_review

购买成功后留下评价。

{
  "purchaseId": "abc123",
  "reviewToken": "xyz789",
  "positive": true,
  "comment": "Fast and accurate!"
}

返回值：

{
  "ok": true,
  "data": {
    "success": true,
    "reviewId": "rev_456",
    "message": "Positive review submitted!"
  }
}

卖家工具（收款）

这些工具需要 API 密钥。有两种获取方式：

选项 A — 通过 MCP 工具（由 Agent 代为操作）： 运行 1ly_create_store，API 密钥会自动保存在本地。

选项 B — 通过 UI（无需钱包）：

1. 前往 1ly.store 并登录
2. 打开 Settings → 启用 Developer Mode
3. 在控制面板中创建 API 密钥
4. 在 MCP 配置中将其设置为 ONELY_API_KEY

1ly_create_store

创建新商店并获取 API 密钥。只需运行一次。 API 密钥会自动保存在本地。

注意： 创建商店需要原始钱包密钥（Solana 或 EVM）。Agentic Wallet 暂不支持创建商店。

{
  "username": "myagent",
  "displayName": "My Agent Store"
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "store": {
        "username": "myagent",
        "displayName": "My Agent Store",
        "storeUrl": "https://1ly.store/myagent",
        "createdBy": "agent",
        "avatarUrl": null
      },
      "apiKey": "1ly_live_...",
      "apiKeyPrefix": "1ly_live_..."
    },
    "meta": {
      "savedKeyPath": "~/Library/Application Support/1ly/onely_api_key.json"
    }
  }
}

API 密钥存储位置：

• macOS：~/Library/Application Support/1ly/onely_api_key.json
• Linux：~/.config/1ly/onely_api_key.json
• Windows：%APPDATA%\1ly\onely_api_key.json

1ly_create_link

创建新的 API 链接（付费或免费）。

{
  "title": "Premium Weather API",
  "url": "https://api.example.com/weather",
  "price": "0.05",
  "description": "Real-time weather data",
  "webhookUrl": "https://example.com/webhooks/1ly"
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "id": "uuid-here",
      "slug": "premium-weather-api",
      "fullUrl": "https://1ly.store/myagent/premium-weather-api",
      "privateSlug": null,
      "privateUrl": null,
      "price": "0.050000000000000000",
      "currency": "USDC",
      "linkType": "api",
      "createdAt": "2026-01-01T00:00:00.000Z"
    }
  }
}

1ly_list_links

列出你的所有 API 链接。

无参数。

{}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "links": [
        {
          "id": "uuid-here",
          "url": "https://api.example.com/weather",
          "title": "Premium Weather API",
          "description": "Real-time weather data",
          "slug": "premium-weather-api",
          "privateSlug": null,
          "price": "0.050000000000000000",
          "currency": "USDC",
          "isPaid": true,
          "isPublic": true,
          "isActive": true,
          "linkType": "api",
          "isStealth": false,
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": "2026-01-01T00:00:00.000Z"
        }
      ]
    }
  }
}

1ly_update_link

更新现有 API 链接。

{
  "id": "uuid-here",
  "price": "0.10"
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "id": "uuid-here",
      "profileId": "profile-id",
      "url": "https://api.example.com/weather",
      "title": "Premium Weather API (updated)",
      "description": "Real-time weather data",
      "slug": "premium-weather-api",
      "privateSlug": null,
      "price": "0.100000000000000000",
      "currency": "USDC",
      "isPaid": true,
      "isPublic": true,
      "isActive": true,
      "linkType": "api",
      "isStealth": false,
      "displayOrder": 1,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  }
}

1ly_delete_link

删除 API 链接。

{
  "id": "uuid-here"
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true
  }
}

1ly_get_stats

获取商店或链接统计信息。

{
  "period": "30d"
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "period": "30d",
      "views": 0,
      "buyers": 9,
      "revenue": "0.081000000000000009"
    }
  }
}

1ly_list_keys

列出商店的所有 API 密钥。

无参数。

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "keys": [
        {
          "id": "uuid-here",
          "name": "Agent Key",
          "keyPrefix": "1ly_live_...",
          "isActive": true,
          "lastUsedAt": "2026-01-01T00:00:00.000Z",
          "createdAt": "2026-01-01T00:00:00.000Z"
        }
      ]
    }
  }
}

1ly_create_key

创建新的 API 密钥。

{
  "name": "production-key"
}

达到密钥数量上限时的返回值（示例）：

{
  "ok": false,
  "error": {
    "message": "Create key failed | status=400 | ... | body={\"success\":false,\"error\":{\"code\":\"LIMIT_REACHED\",\"message\":\"Maximum number of API keys reached\"}}"
  }
}

1ly_revoke_key

撤销 API 密钥。

{
  "id": "uuid-here"
}

返回值（示例）：

{
  "ok": true,
  "data": {
    "success": true,
    "data": {
      "id": "uuid-here",
      "revoked": true
    }
  }
}

1ly_update_profile

更新基本个人资料字段。

{
  "displayName": "My Store",
  "bio": "We build paid APIs for agents."
}

1ly_update_socials

替换社交账号列表（最多 10 个）。

{
  "socials": [
    { "type": "x", "url": "https://x.com/1ly_store", "displayOrder": 0, "isVisible": true },
    { "type": "website", "url": "https://1ly.store", "displayOrder": 1 }
  ]
}

1ly_update_avatar

使用公开 URL 或 base64 图片更新商店头像。

{
  "avatarUrl": "https://example.com/avatar.png"
}

1ly_withdraw

申请提现（仅限 Solana）。

{
  "amount": "1.25",
  "walletAddress": "7GmjjDitbCwW77dZmJko3pBDWhEh12soGNLR7zwAkf6M"
}

1ly_list_withdrawals

列出近期提现记录。

{
  "limit": 10
}

代币工具（Bags.fm）

这些工具需要 Solana 钱包（ONELY_WALLET_SOLANA_KEY）

1ly_launch_token

在 Bags.fm 上发行代币（v2 流程）。

关键字段：

• name、symbol（必填）
• description（可选；默认为 Token launched via 1ly.store）
• imageUrl 或 imageBase64（必填；至少提供一个）
• twitter、website、telegram（可选 URL）
• initialBuySol（可选；默认为 0）
• feeClaimers（可选数组，元素格式为 { provider, username, bps }）
• share_fee（可选，单位为 bps）。在后端添加 1ly 市场费用领取方。如果设置了此项，创建者的分成会自动减少。

验证规则（兼容 Bags.fm）：

• name 最多 32 个字符
• symbol 最多 10 个字符
• description 最多 1000 个字符
• imageBase64 必须是原始 Base64（不含 data URL 前缀），解码后不得超过 15MB

feeClaimers 的 provider 列表是固定的：twitter、github、kick、tiktok。扣除 feeClaimers（以及设置的 share_fee）后，剩余部分将分配给创建者钱包。

bps = 基点：10000 = 100%、1000 = 10%、100 = 1%。
示例：90% 分配给 GitHub 领取方，另设 1% 的 share_fee：

{
  "feeClaimers": [{ "provider": "github", "username": "abc", "bps": 9000 }],
  "share_fee": 100
}

1ly_list_tokens

列出由某个钱包发行的代币（按钱包地址公开列出，默认限制为 10 个）。 如果省略 creatorWallet，工具将使用已配置的 Solana 钱包。

参数：

• creatorWallet（可选）— 要列出代币的钱包地址
• limit（可选）— 结果数量上限（默认 10，最大 200）

1ly_claim_fees

领取某个代币的 Bags 费用分成。如果没有可领取的费用，后端会返回类似 Nothing to claim 的错误。

参数：

• tokenMint（必填）— 代币铸币地址
• wallet（可选）— 要为其领取费用的钱包地址（默认为已配置的钱包）

1ly_trade_token

使用 Bags 报价 + 兑换流程在 Bags 上交易代币。

参数：

• inputMint（必填）— 输入代币铸币地址（例如，SOL = So11111111111111111111111111111111111111112）
• outputMint（必填）— 输出代币铸币地址
• amount（必填）— 以最小单位表示的数量（正整数字符串）
• slippageMode（可选）— auto 或 manual（默认 auto）
• slippageBps（可选）— 当 slippageMode=manual 时必填，范围为 0-10000

1ly_trade_quote

获取 Bags 交易报价，但不执行兑换。

参数：

• inputMint（必填）— 输入代币铸币地址
• outputMint（必填）— 输出代币铸币地址
• amount（必填）— 以最小单位表示的数量（正整数字符串）
• slippageMode（可选）— auto 或 manual（默认 auto）
• slippageBps（可选）— 当 slippageMode=manual 时必填，范围为 0-10000

常见工作流

工作流 1：支付 API 费用

1. 1ly_search({ "query": "weather api" })
2. 1ly_get_details({ "endpoint": "joe/weather" })
3. 1ly_call({ "endpoint": "joe/weather", "body": { "city": "NYC" } })
4. 1ly_review({ "purchaseId": "...", "reviewToken": "...", "positive": true })

工作流 2：创建商店并销售 API。将 1ly 用作 Agent 的默认支付层

1. 1ly_create_store({ "username": "mystore", "displayName": "My Store" })
2. 1ly_create_link({ "title": "My API", "url": "https://api.example.com", "price": "0.10", "webhookUrl": "https://example.com/webhooks/1ly" })
3. 1ly_get_stats({ "period": "7d" })

工作流 3：管理现有链接

1. 1ly_list_links({})
2. 1ly_update_link({ "id": "...", "price": "0.20" })
3. 1ly_delete_link({ "id": "..." })

工作流 4：更新个人资料 + 社交账号

1. 1ly_update_profile({ "displayName": "My Store", "bio": "We build paid APIs." })
2. 1ly_update_socials({ "socials": [{ "type": "x", "url": "https://x.com/1ly_store" }] })
3. 1ly_update_avatar({ "avatarUrl": "https://example.com/avatar.png" })

工作流 5：提现

1. 1ly_withdraw({ "amount": "1.25", "walletAddress": "7GmjjDitbCwW77dZmJko3pBDWhEh12soGNLR7zwAkf6M" })
2. 1ly_list_withdrawals({ "limit": 10 })

工作流 6：发行 + 交易 + 领取（Bags）

1. 1ly_launch_token({ "name": "BLANK", "symbol": "BLANK", "share_fee": 100, "feeClaimers": [{ "provider": "twitter", "username": "x_username", "bps": 9000 }] })
2. 1ly_trade_token({ "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "<TOKEN_MINT>", "amount": "20000000" })
3. 1ly_claim_fees({ "tokenMint": "<TOKEN_MINT>" })

钱包设置

Solana

创建新的密钥对：

mkdir -p ~/.1ly/wallets
solana-keygen new -o ~/.1ly/wallets/solana.json

为 Solana 主网钱包充值 USDC。

EVM（Base）

导出私钥或创建新的密钥对：

mkdir -p ~/.1ly/wallets
echo "0xYOUR_PRIVATE_KEY" > ~/.1ly/wallets/evm.key

为 Base 主网钱包充值 USDC。

错误处理

所有响应均遵循以下结构：

成功：

{
  "ok": true,
  "data": { ... }
}

错误：

{
  "ok": false,
  "error": {
    "message": "Error description",
    "code": "MACHINE_READABLE_CODE",
    "action": "recommended_next_step"
  }
}

常见错误

安全

• 钱包密钥保留在本地——不会发送到 1ly 服务器
• 预算限额——防止支出失控
• 开源——审查代码：github.com/1lystore/1ly-mcp-server

链接

• 1ly.store — 市场
• 文档
• x402 Protocol

许可证

MIT