使用说明

项目简介

本项目 'SOLANA_TRACKER_MCP_SERVER' 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型 (LLM) 应用提供 Solana 区块链上代币的实时和历史数据。它通过 MCP 协议标准化的工具 (Tools) 接口,向客户端暴露了一系列用于查询 Solana 代币信息的工具,例如代币价格、交易数据、持币人信息等。

主要功能点

  • 代币信息查询: 提供多种工具查询 Solana 代币的详细信息,包括基本信息、价格、ATH、持币人、交易数据等。
  • 钱包数据查询: 支持根据钱包地址查询该钱包持有的代币信息和交易历史。
  • 趋势和最新代币: 提供查询 Solana 链上趋势代币和最新创建代币的工具。
  • 图表数据: 支持获取代币的价格和交易量图表数据。
  • 利润与亏损 (PNL) 分析: 提供工具分析钱包或代币的盈亏情况。
  • 基于 Solana Tracker API: 数据来源于 Solana Tracker API,保证数据的准确性和实时性。

安装步骤

  1. 克隆仓库

    git clone https://github.com/8bitsats/SOLANA_TRACKER_MCP_SERVER.git
    cd SOLANA_TRACKER_MCP_SERVER
  2. 安装依赖 确保你已经安装了 Node.js 和 npm。运行以下命令安装项目依赖:

    npm install
  3. 设置 Solana Tracker API 密钥 你需要从 Solana Tracker 获取 API 密钥,并将其设置为环境变量 'SOLANA_TRACKER_API_KEY'。

    export SOLANA_TRACKER_API_KEY=YOUR_API_KEY

    或者,你也可以将密钥添加到 '.env' 文件中(如果项目支持)。

  4. 构建项目 运行以下命令构建项目:

    npm run build

服务器配置

为了让 MCP 客户端连接到 'SOLANA_TRACKER_MCP_SERVER',你需要配置客户端的服务器连接信息。以下是一个示例 JSON 配置,你需要将其添加到 MCP 客户端的服务器列表中。

{
  "server_name": "solana-tracker-server",  // 服务器名称,与代码中定义的一致
  "command": "node",                     // 启动服务器的命令,这里使用 node
  "args": ["build/index.js"]             // 启动命令的参数,指向构建后的服务器入口文件
}

配置参数说明:

  • 'server_name': 服务器的唯一标识名称,客户端通过此名称识别服务器。
  • 'command': 启动服务器程序的可执行命令。由于本项目是 Node.js 应用,所以使用 'node' 命令。
  • 'args': 传递给启动命令的参数列表。这里指向了 'build/index.js',即构建后的服务器入口文件。

基本使用方法

  1. 启动服务器 在项目根目录下,运行以下命令启动 MCP 服务器:

    npm start

    服务器将监听 MCP 客户端的请求。

  2. 在 MCP 客户端中使用

    • 将上述提供的服务器配置信息添加到你的 MCP 客户端配置中。
    • 客户端成功连接到服务器后,即可通过 MCP 协议调用服务器提供的工具 (Tools) 来查询 Solana 链上数据。
    • 使用 'ListToolsRequest' 获取服务器支持的所有工具列表及其详细信息(名称、描述、输入参数等)。
    • 使用 'CallToolRequest' 调用具体的工具,并根据工具的 'inputSchema' 传入相应的参数。
    • 服务器将返回包含查询结果的 'content',通常为 JSON 格式的数据。

例如,使用 'get_token_information' 工具查询代币信息:

客户端发送 'CallToolRequest' 请求,'params' 如下:

{
  "name": "get_token_information",
  "arguments": {
    "tokenAddress": "YOUR_TOKEN_ADDRESS"  // 替换为你要查询的 Solana 代币地址
  }
}

服务器将返回包含该代币信息的 JSON 响应。

请参考代码中的 'setupToolHandlers' 函数和 'CallToolRequestSchema' 处理逻辑,了解每个工具的具体用法和参数。

信息

分类

网页与API