dex-kline-mcp

🚀 DEX K线MCP

这是一个MCP服务器，它可以从去中心化交易所（DEX）流式传输K线（蜡烛图）数据，为你的AI智能体和工作流程提供支持。

✨ 主要特性

• K线数据检索：可获取支持的区块链（以太坊、币安智能链、Solana）上指定代币的OHLCV（开盘价、最高价、最低价、收盘价、成交量）数据。
• 动态时间框架：通过相应的API端点支持多种时间框架（1m、5m、15m、1h、4h、12h、1d）。
• 最佳交易池选择：自动选择流动性最高的交易池，以获取准确的数据。
• 灵活的结束时间：允许以ISO 8601格式指定结束时间，若未指定则默认为当前的UTC时间。
• 表格输出：使用tabulate库将K线数据格式化为简洁易读的表格。

📦 安装指南

前提条件

• Python 3.10 或更高版本
• uv 用于依赖管理

安装步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/dex-kline-mcp.git
   cd dex-kline-mcp
   

2. 安装依赖：

   uv sync
   

3. 安装到Claude桌面端：

   将服务器作为Claude桌面应用程序进行安装：

   uv run mcp install main.py --name "DEX K-line"
   

   参考配置文件如下：

   {
      "mcpServers": {
          "DEX K-line": {
              "command": "uv",
              "args": [ "--directory", "/path/to/dex-kline-mcp", "run", "main.py" ]
          }
      }
   }
   

   请将/path/to/dex-kline-mcp替换为你实际的安装路径。

💻 使用示例

工具：get_kline

服务器提供了一个名为get_kline的工具，用于检索指定代币的K线数据。

参数

• chain（字符串）：区块链网络（例如，eth、bsc、solana）
• address（字符串）：代币合约地址
• timeframe（字符串）：K线时间框架（例如，1m、5m、15m、1h、4h、12h、1d）。默认值：1h
• end_time（字符串，可选）：数据结束时间的ISO 8601时间戳（例如，2025-07-03T02:14:00Z）。默认值：当前的UTC时间
• limit（整数）：返回的数据点数（最多1000个）。默认值：100

示例提示

获取币安智能链（BSC）上合约地址为 0xf4b385849f2e817e92bffbfb9aeb48f950ff4444 的代币的1小时K线数据。

示例输出

Pair: TOKEN/USDT

+---------------------+------------+------------+------------+------------+------------+
| Timestamp           | Open       | High       | Low        | Close      | Volume     |
+---------------------+------------+------------+------------+------------+------------+
| 2025-07-03 01:00:00 | 0.12345678 | 0.12345678 | 0.12345678 | 0.12345678 | 1234.56789 |
| 2025-07-03 00:00:00 | 0.12345678 | 0.12345678 | 0.12345678 | 0.12345678 | 1234.56789 |
+---------------------+------------+------------+------------+------------+------------+

📄 许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。

致谢

数据由 GeckoTerminal API 提供支持。