使用说明

项目简介

Bonk Token Launchpad MCP 服务器是一个符合 Model Context Protocol (MCP) 标准的后端应用,专注于为基于大型语言模型 (LLM) 的客户端提供与 Solana 区块链交互的能力,特别是支持在 LetsBonk Launchpad 上进行代币的发行、交易以及获取市场行情。

主要功能点

  • 代币发行 (Token Launching): 允许用户通过简单的指令发行新的 Solana 代币,包括配置代币名称、符号、描述、图片等元数据。
  • 代币交易 (Token Trading): 支持在 LetsBonk Launchpad 上购买指定代币。
  • 行情查询 (Market Data): 集成 BirdEye API,可以获取 Solana 链上热门(trending)代币列表和顶尖交易者的信息。

安装步骤

  1. 安装 Python: 确保您的系统安装了 Python 3.8 或更高版本。
  2. 安装 uv: 这是一个快速的 Python 包管理器,推荐用于安装依赖。如果未安装,可以按照 uv 官方文档进行安装。
  3. 克隆仓库: 将 bonk-mcp 仓库克隆到您的本地计算机。
  4. 安装依赖: 打开终端,进入克隆的 'bonk-mcp' 目录,使用 uv 安装项目依赖:
    uv sync

服务器配置

此 MCP 服务器需要配置您的 Solana 密钥对和 RPC 端点才能执行代币发行和交易等操作。您需要在您的 MCP 客户端(例如 Claude Desktop)的配置中添加此服务器。配置通常是一个 JSON 对象,包含以下关键信息:

  • 服务器名称 (Server Name): 用于在客户端中标识此服务器,例如 'bonk-mcp'。
  • 启动命令 (Command): 启动服务器的可执行文件。在安装了 uvx 后,通常可以直接使用包名作为命令,例如 'uvx'。
  • 命令参数 (Args): 传递给启动命令的参数。对于 bonk-mcp,通常是运行其主入口点,例如 '["bonk-mcp"]'。如果是在开发环境中直接从源代码运行,可能需要指定目录和运行模块,例如 '["--directory", "/path/to/bonk-mcp", "run", "bonk-mcp"]'。
  • 环境变量 (Environment Variables): 传递给服务器进程的环境变量。对于此服务器,必须配置:
    • 'KEYPAIR': 您的 Solana 账户的私钥(Base58 格式)。服务器将使用此密钥对支付交易费用和执行链上操作。请务必妥善保管您的私钥。
    • 'RPC_URL': 连接到的 Solana RPC 端点的 URL (例如 'https://api.mainnet-beta.solana.com' 或一个开发网络的 URL)。
    • 'BIRDEYE_API_KEY': 用于访问 BirdEye API 以获取市场数据的 API 密钥(可选,如果只需要代币发行交易功能则无需)。

示例配置概念(请根据您的MCP客户端文档进行实际配置):

{
  "mcpServers": {
    "bonk-mcp": {
      "command": "uvx", // 或根据实际情况写启动命令
      "args": ["bonk-mcp"], // 或根据实际情况写参数
      "env": {
        "KEYPAIR": "<YOUR_SOLANA_PRIVATE_KEY_BASE58>", // 替换为您的Solana私钥
        "RPC_URL": "https://api.mainnet-beta.solana.com", // 替换为您的RPC端点
        "BIRDEYE_API_KEY": "<YOUR_BIRDEYE_API_KEY>" // 替换为您的BirdEye API密钥(可选)
      }
    }
  }
}

注意: 上述 JSON 仅为配置概念示例,请参照您使用的 MCP 客户端(如 Claude Desktop)的官方文档找到正确的配置位置和格式,并填入您的实际值。特别是 'KEYPAIR' 和 'RPC_URL' 是进行链上操作所必需的。

基本使用方法

一旦服务器在您的 MCP 客户端中配置并成功启动,LLM 客户端将能够发现并调用服务器提供的工具和资源。

  • 与 LLM 交互: 在 LLM 客户端中,您可以通过自然语言描述您希望执行的任务,例如:
    • "帮我在 LetsBonk 上发行一个叫做 'My Awesome Token',符号是 'MAT',描述是 'This is the best token ever!',图片是 [提供图片URL] 的代币。" (这将触发 'launch-token' 工具)
    • "我想用 0.1 SOL 购买地址为 [代币地址] 的代币。" (这将触发 'buy-token' 工具)
    • "显示一下 Solana 上当前的热门代币。" (这将触发 'birdeye-trending-tokens' 工具)
    • "看看今天 Solana 上盈利最多的交易者是哪些。" (这将触发 'birdeye-top-traders' 工具)
  • LLM 客户端会根据您的请求,将相应的参数发送给 bonk-mcp MCP 服务器。
  • 服务器执行操作后,将结果(如交易签名、错误信息、列表数据等)通过 MCP 协议返回给 LLM 客户端,客户端会向您展示结果。

请确保您配置的 Solana 账户有足够的 SOL 来支付交易费用和代币购买的金额。进行链上操作有风险,请谨慎使用。

信息

分类

网页与API