使用说明
项目简介
本项目 'SOLANA_TRACKER_MCP_SERVER' 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型 (LLM) 应用提供 Solana 区块链上代币的实时和历史数据。它通过 MCP 协议标准化的工具 (Tools) 接口,向客户端暴露了一系列用于查询 Solana 代币信息的工具,例如代币价格、交易数据、持币人信息等。
主要功能点
- 代币信息查询: 提供多种工具查询 Solana 代币的详细信息,包括基本信息、价格、ATH、持币人、交易数据等。
- 钱包数据查询: 支持根据钱包地址查询该钱包持有的代币信息和交易历史。
- 趋势和最新代币: 提供查询 Solana 链上趋势代币和最新创建代币的工具。
- 图表数据: 支持获取代币的价格和交易量图表数据。
- 利润与亏损 (PNL) 分析: 提供工具分析钱包或代币的盈亏情况。
- 基于 Solana Tracker API: 数据来源于 Solana Tracker API,保证数据的准确性和实时性。
安装步骤
-
克隆仓库
git clone https://github.com/8bitsats/SOLANA_TRACKER_MCP_SERVER.git cd SOLANA_TRACKER_MCP_SERVER -
安装依赖 确保你已经安装了 Node.js 和 npm。运行以下命令安装项目依赖:
npm install -
设置 Solana Tracker API 密钥 你需要从 Solana Tracker 获取 API 密钥,并将其设置为环境变量 'SOLANA_TRACKER_API_KEY'。
export SOLANA_TRACKER_API_KEY=YOUR_API_KEY或者,你也可以将密钥添加到 '.env' 文件中(如果项目支持)。
-
构建项目 运行以下命令构建项目:
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',即构建后的服务器入口文件。
基本使用方法
-
启动服务器 在项目根目录下,运行以下命令启动 MCP 服务器:
npm start服务器将监听 MCP 客户端的请求。
-
在 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