快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

npx @modelcontextprotocol/inspector node dist/index.js

详细介绍

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：

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

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

从npm进行全局安装（通过pnpm）

pnpm add -g mcp-coinglass

从源头建设（发展）

pnpm install
pnpm run build
pnpm run start

出于测试和开发目的，使用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

目录标签

加密货币TypeScript数据分析API集成本地部署期货市场MCP协议API服务

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Node.js

来源包（packageName，安装包名）

@modelcontextprotocol/inspector

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/51b56d3b23b3614b89c9c204eee7dd9c

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

继续浏览同类 MCP

更多金融服务 MCP（2,622）返回 MCP 目录

上一个 MCP

MCP Coingecko Server

一个用于加密货币数据查询的Model Context Protocol服务器，提供通过大语言模型与CoinGecko API交互的工具，可查询加密货币价格、历史数据和市场信息。

下一个 MCP

MCP Colombia

MCP服务器连接任何AI代理与哥伦比亚服务，通过Soulprint提供身份验证和行为声誉管理。

MCP Coinglass