AI导哈

加密货币期货数据分析服务

MCP-Coinglass是一个为CoinGlass API (v4)实现的模型上下文协议(MCP)服务器，提供期货市场数据分析功能，包括未平仓合约、清算、多空比率和资金费率等。

  • by GPSxtreme
  • TypeScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 GPSxtreme/mcp-coinglass

使用说明

MCP-硬币玻璃

该项目为CoinGlass API（v4）实现了一个模型上下文协议（MCP）服务器。它允许MCP兼容的客户端（AI助手、IDE扩展或自定义应用程序）访问期货市场分析，如未平仓合约、清算、多头/空头比率和资金利率。

功能（MCP工具）

服务器公开了MCP客户端可以调用的以下工具：

  • COINGLASS_OPENINTEREST：某个交易品种的开放式兴趣交换列表；可选历史记录

    • 参数：符号（字符串），交换？（字符串），包括历史？（布尔值），句号？（“1h”|“4h”|“12h”|“24h”）

  • COINGLASS_LIQUITIONS_PAIR：历史对清算（v4/api/期货/清算/历史）

    • 参数：交换（字符串）、符号（字符串）和间隔？（1米| 3米| 5米| 15米| 30米| 1小时| 4小时| 6小时| 8小时| 12小时| 1天| 1周），限值？开始时间？结束时间？，漂亮格式？（默认值：true）

  • COINGLASS_LIQUITIONS_COIN：聚合硬币清算（v4/api/期货/清算/聚合历史）

    • 参数：exchange_list（字符串）、symbol（字符串）和interval？（与上述相同），限制？开始时间？结束时间？，漂亮格式？（默认值：true）

  • COINGLASS_LONG_SHORT_RATIO：全球账户长/短比率快照

    • 参数：符号（字符串），交换？（字符串），句号？（“1h”|“4h”|“12h”|“24h”），格式好吗？（布尔值，默认值：true）

  • COINGLASS_FUNDING_RATE：各交易所的当前融资率

    • 参数：符号（字符串），交换？（字符串），pretty格式？（布尔值，默认值：true）

  • COINGLASS_HYPERLIQUID_WHALE_ALERT：实时超液态鲸鱼警报（>100万美元）

  • 参数：prettyFormat？（布尔值，默认值：true）

  • COINGLASS_HYPERLIQUID_WHALE_POSITION：实时超液体鲸鱼位置（>100万美元）

  • 参数：prettyFormat？（布尔值，默认值：true）

即使在api错误的情况下，工具调用响应也总是返回成功代码。如果发生错误，工具响应包括原始api响应。

先决条件

  • Node.js v20+（CI使用Node 22）
  • pnpm(https://pnpm.io/installation)

安装

有几种方法可以运行mcp coinglass：

  1. 使用pnpm-dlx（建议用于大多数MCP客户端设置）

直接运行已发布的软件包，无需全局安装。请参阅下面的MCP客户端配置示例。

  1. 从npm进行全局安装（通过pnpm）
pnpm add -g mcp-coinglass
  1. 从源头建设（发展）
pnpm install
pnpm run build
pnpm run start
  1. 出于测试和开发目的，使用mcp检查器
# in the project root run,
pnpm run build
npx @modelcontextprotocol/inspector node dist/index.js

配置（环境变量）

此服务器需要CoinGlass API密钥。所有CoinGlass v4端点都需要CG-API-KEY头。从帐户仪表板生成API密钥，并通过环境变量提供。参考文献

  • 身份验证文档：https://docs.coinglass.com/reference/authentication
  • 账户/API关键仪表板：https://www.coinglass.com/account

使用以下命令创建.env文件（或在MCP客户端中配置env）：

COINGLASS_API_KEY=your_api_key_here

包含一个.env.sample文件作为参考；将其复制到.env并填写密钥。

注意：所有可用的工具都需要升级的coinglass api计划才能工作

使用MCP客户端运行服务器

MCP客户端（助手、IDE扩展）将此服务器作为后台进程运行。使用类似于以下内容的服务器条目配置您的客户端。

使用pnpm-dlx：

{
  "mcpServers": {
    "coinglass-mcp-server": {
      "command": "pnpm",
      "args": ["dlx", "mcp-coinglass"],
      "env": {
        "COINGLASS_API_KEY": "your_api_key_here"
      }
    }
  }
}

如果全局安装（pnpm add-g mcp-coinglass）：

{
  "mcpServers": {
    "coinglass-mcp-server": {
      "command": "mcp-coinglass",
      "args": [],
      "env": {
        "COINGLASS_API_KEY": "your_api_key_here"
      }
    }
  }
}

工具调用示例

MCP客户端将JSON参数传递给工具。示例：

{ "tool": "COINGLASS_OPEN_INTEREST", "params": { "symbol": "BTC", "includeHistory": true, "period": "24h" } }

{ "tool": "COINGLASS_LIQUIDATIONS", "params": { "symbol": "BTCUSDT", "timeframe": "4h" } }

{ "tool": "COINGLASS_LIQUIDATIONS_PAIR", "params": { "exchange": "Binance", "symbol": "BTCUSDT", "interval": "4h" } }

{ "tool": "COINGLASS_LIQUIDATIONS_COIN", "params": { "exchange_list": "Binance,OKX,Bybit", "symbol": "BTC", "interval": "1d" } }

{ "tool": "COINGLASS_LONG_SHORT_RATIO", "params": { "symbol": "ETH", "period": "1h" } }

{ "tool": "COINGLASS_FUNDING_RATE", "params": { "symbol": "SOL" } }

{ "tool": "COINGLASS_HYPERLIQUID_WHALE_ALERT", "params": {} }

{ "tool": "COINGLASS_HYPERLIQUID_WHALE_POSITION", "params": {} }

默认人类可读输出示例（prettyFormat=true）

这些是默认的格式化输出。集 prettyFormat 向 false 以接收原始的API形状的响应。

融资利率

Funding Rate for BTCUSDT:
Average: 0.0100% | Next Funding: 2024-08-06T08:00:00.000Z
Exchanges: 12

{
  "averageRate": 0.0001,
  "nextFundingTime": 1722960000000,
  "exchanges": [
    { "exchange": "Binance", "rate": -0.0000335, "predictedRate": -0.00002, "nextFundingTime": 1722960000000 }
    // ...
  ]
}

开放兴趣

Open Interest for BTCUSDT:
Total OI (All): $123456789
24h Change: 2.34%

{
  "exchangeList": [ /* ... */ ],
  "history": { /* optional when includeHistory=true */ }
}

清算（对）

Liquidations (Pair) for BTCUSDT [48 points]:
Latest: Long $1.23M | Short $2.34M
Totals: Long $56.78M | Short $67.89M

{
  "latest": { /* latest data point */ },
  "totals": { "long": 56780000, "short": 67890000 },
  "points": [ /* ... */ ]
}

清算（硬币合计）

Liquidations (Coin Aggregated) for BTC [48 points]:
Latest: Long $1.23M | Short $2.34M
Totals: Long $56.78M | Short $67.89M

{
  "latest": { /* latest data point */ },
  "totals": { "long": 56780000, "short": 67890000 },
  "points": [ /* ... */ ]
}

全球多头/空头账户比率

Long/Short Ratio for BTCUSDT:
Long: 73.24% | Short: 26.76% | Ratio: 2.74

{
  "latest": { /* latest data point */ },
  "points": [ /* ... */ ]
}

超液态鲸鱼警报

Hyperliquid Whale Alerts: 8 events
Top 5 by position value:

{
  "top": [
    { "user": "0xabc...", "symbol": "BTC", "positionValueUsd": 2936421.48, "positionAction": 2, "createTime": 1745219477000 }
    // ...
  ],
  "events": [ /* ... */ ]
}

超液态鲸鱼位置

Hyperliquid Whale Positions: 6 positions (top 5 by value)

{
  "top": [
    { "user": "0xdef...", "symbol": "ETH", "positionSize": -44727.13, "positionValueUsd": 73589542.55, "leverage": 25, "unrealizedPnl": 27033236.42, "marginMode": "cross", "updateTime": 1745219966000 }
    // ...
  ],
  "positions": [ /* ... */ ]
}

脚本

  • pnpm run build：将TypeScript编译为dist/并使输出可执行
  • pnpm run start：通过stdio运行内置服务器（用于MCP）
  • pnpm运行lint：通过Biome的lint
  • pnpm运行格式：通过Biome格式化

端点引用（v4）

此服务器调用这些REST端点：

  • 未平仓合约交易列表：GET/api/futures/未平仓合约/交易列表
  • 未平仓合约历史（OHLC）：GET/api/futures/未平仓合约/历史
  • 清算历史：GET/api/期货/清算/历史
  • 全球多头/空头账户比率历史记录：GET/api/futures/全球多头-空头账户比率/历史记录
  • 资金汇率列表：GET/api/期货/资金汇率/汇率列表

请参阅官方文件了解身份验证和速率限制：

  • https://docs.coinglass.com/reference/authentication

相关 MCP