Funding Rates MCP

Funding Rates MCP

一个 MCP 服务，可提供主流加密货币交易所的实时资金费率数据，帮助 Agent 发现套利机会。

功能

• 实时资金费率：获取 Binance、OKX、Bybit、Bitget、Gate 和 CoinEx 的当前资金费率。
• 透视表输出：以交易对为行、交易所为列，并包含一个 Divergence 列，显示最大资金费率差值。
• Claude Desktop 集成：作为 MCP 服务运行，支持交互式查询。

安装

先决条件

• Python 3.10+
• 用于依赖管理的 uv
• Claude Desktop（可选，用于交互式查询）
• Git

步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/funding-rates-mcp.git
   cd funding-rates-mcp
   

2. 使用 uv 设置依赖项：

   uv sync
   

3. 配置 Claude Desktop：

   要与 Claude Desktop 配合使用：

   1. 编辑 Claude 配置文件：
      • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows：%APPDATA%\Claude\claude_desktop_config.json
   2. 添加 MCP 服务：

      {
        "mcpServers": {
          "funding-rates-mcp": {
            "command": "uv",
            "args": ["--directory", "/absolute/path/to/funding-rates-mcp", "run", "funding-rates-mcp"]
          }
        }
      }
      

   3. 重启 Claude Desktop。查看锤子图标以确认集成成功。

用法

工具

该服务提供以下 MCP 工具，用于查询资金费率：

• compare_funding_rates：
  • 描述：比较指定交易所中多个交易对的当前资金费率，并返回一个透视 Markdown 表格，其中的 Divergence 列显示每个交易对的最大资金费率差值。
  • 参数：
    • symbols (List[str])：交易对列表（例如，["BTC/USDT:USDT", "ETH/USDT:USDT"]）。必填。
    • exchanges (List[str], optional)：要比较的交易所列表（例如，["binance", "okx"]）。默认为所有受支持的交易所（binance、okx、bybit、bitget、gate、coinex）。
    • params (Dict, optional)：API 调用的其他参数。默认为 {}。
  • 返回值：一个 Markdown 表格，以交易对为行、交易所为列，单元格值为资金费率（格式为百分比），并包含一个 Divergence 列。
  • 示例：请参阅下方的示例部分。

提示词

该服务包含以下 MCP 提示词，用于生成自然语言查询：

• compare_funding_rates_prompt：
  • 描述：生成用于比较所有受支持交易所资金费率的自然语言提示词，适合在 Claude Desktop 中输入。
  • 参数：
    • symbols (List[str])：交易对列表（例如，["BTC/USDT:USDT", "ETH/USDT:USDT"]）。必填。
  • 返回值：一个字符串提示词（例如，“Compare the funding rates for BTC/USDT:USDT, ETH/USDT:USDT across binance, okx, bybit, bitget, gate, coinex.”）。
  • 用法：由 Claude Desktop 在内部使用，以解析用户查询；也可用于在 MCP Inspector 中测试。

示例

比较资金费率

• 输入（在 Claude Desktop 中）：
  “比较所有交易所中 BTC/USDT:USDT 和 ETH/USDT:USDT 的资金费率。”
• 输出：

  Current funding rates:
  
  | Symbol\Exchange | binance   | okx       | bybit     | bitget    | gate      | coinex    | Divergence |
  |-----------------|-----------|-----------|-----------|-----------|-----------|-----------|------------|
  | BTC/USDT:USDT   | 0.005161% | 0.007548% | 0.010000% | 0.002900% | -0.019200% | -0.035013% | 0.045013%  |
  | ETH/USDT:USDT   | 0.010000% | 0.005839% | 0.010000% | 0.010000% | -0.008200% | 0.000000%  | 0.018200%  |
  

比较指定交易所

• 输入（在 Claude Desktop 中）：
  “比较 Binance、OKX 和 Bybit 上 SOL/USDT:USDT 的资金费率。”
• 输出：

  Current funding rates:
  
  | Symbol\Exchange | binance   | okx       | bybit     | Divergence |
  |-----------------|-----------|-----------|-----------|------------|
  | SOL/USDT:USDT   | -0.015312% | -0.003639% | -0.004467% | 0.011673%  |
  

许可证

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