项目简介

该项目是一个基于Model Context Protocol (MCP) 的服务器,旨在向AI助手(如Claude)提供OKX交易所的实时加密货币数据。它允许AI访问最新的价格信息、历史K线数据,并支持实时WebSocket更新和增强的可视化功能。

主要功能点

  • 获取最新价格: 查询指定加密货币交易对的实时最新价格,支持格式化展示。
  • 获取历史K线数据: 检索指定交易对的历史K线图数据,支持不同时间间隔,并提供可视化选项(包括ASCII图表和表格)。
  • 实时行情订阅: 订阅指定交易对的实时价格更新,通过WebSocket获取数据。
  • 获取实时行情: 获取当前已订阅交易对的最新实时数据,支持格式化展示。
  • 取消实时行情订阅: 停止接收指定交易对的实时更新。
  • 数据可视化: 提供价格数据的格式化输出、24小时价格区间可视化,以及K线数据的统计摘要、ASCII图表和表格展示。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/badger3000/okx-mcp-server.git
    cd okx-mcp-server
  2. 安装依赖: 确保已安装 Node.js (推荐 v16 或更高版本) 和 npm 或 yarn。
    npm install
    npm install ws --save-dev @types/ws # 添加WebSocket相关依赖
  3. 构建项目:
    npm run build
  4. 设置可执行权限:
    chmod +x build/index.js

服务器配置 (用于MCP客户端集成)

MCP服务器通常需要与支持MCP协议的客户端(如VSCode的Claude扩展或Claude桌面应用)集成。你需要告知客户端如何启动此MCP服务器。

例如,在VSCode的Claude扩展中,你需要编辑 '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' 文件,添加如下配置信息:

  • '"okx"': 这是给你的MCP服务器起的一个唯一名称,客户端将用它来引用此服务器。
    • '"command": "node"': 这是启动MCP服务器的命令。
    • '"args": ["/absolute/path/to/okx-mcp-server/build/index.js"]': 这是传递给启动命令的参数,指向编译后的服务器脚本的绝对路径。
    • '"disabled": false': 设置为 'false' 以启用服务器。
    • '"autoApprove": []': 用于自动批准某些权限。

请务必将 '/absolute/path/to/okx-mcp-server/build/index.js' 替换为你本地实际的服务器脚本路径。

基本使用方法 (与AI助手交互)

配置完成后,你可以在AI助手(如Claude)中通过自然语言提问,AI将自动调用相应的MCP工具获取OKX数据。例如:

  • “比特币(BTC-USDT)的当前价格是多少?以漂亮格式显示。”
  • “显示以太坊(ETH-USDT)过去一小时的5分钟K线图,并提供可视化表示。”
  • “订阅比特币的实时价格更新,并在价格变动时通知我。”
  • “告诉我以太坊的最新实时数据。”
  • “分析SOL-USDT最近20个1分钟K线,以表格形式显示。”
  • “比特币的当前价格是否高于其24小时高点?可视化价格范围。”

信息

分类

AI与计算