MCP Market Data Server

MCP Market Data Server

---

🎯 概述

MCP Market Data Server 是一个可用于生产环境的金融分析服务，基于 Model Context Protocol（MCP） 实现。它提供四种强大的分析工具，带来机构级市场洞察：

• 🎚️ 成交量分布分析 - 根据成交量分布识别关键支撑位和阻力位
• 📈 技术分析 - 使用 15 种以上标准指标进行多时间周期分析
• 🎯 技术区域 - 计算高概率价格区域，精准制定入场和出场决策
• 📊 ORB 分析 - 提供开盘区间突破水平，通过多周期分析支持日内交易和 0DTE 交易
• 🔍 公允价值缺口分析 - 检测价格失衡和未填补的缺口，用于均值回归交易

适用于算法交易、量化分析和 AI 驱动的交易 Agent。

✨ 功能特性

📊 多时间周期分析

• ⏱️ 1 分钟：剥头皮交易和微小波动分析
• ⏱️ 5 分钟：日内波段交易
• ⏱️ 1 天：仓位交易和趋势分析

📈 成交量分布分析

• 🎯 识别控制点（POC）
• 📊 计算价值区间高点/低点（VAH/VAL）
• 🔥 检测高/低成交量节点
• 💹 分析成交量动态和动量
• 📈 评估上涨概率

🔧 技术指标套件

• 移动平均线：SMA（20、50、200）、EMA（20）、VWAP
• 动量：RSI、MACD、随机振荡指标
• 波动率：ATR（平均真实波幅）
• 成交量：OBV、CMF、成交量变化率
• 高级指标：一目均衡表、趋势强度分析
• 形态：背离检测

🎯 智能区域分析

• 📐 斐波那契回撤位/扩展位
• 📅 前一日高点/低点
• 📊 基于 ATR 的波动率区域
• 🎚️ 根据成交量分布推导的区域
• 🎨 区域强度分类

📊 开盘区间突破（ORB）

• ⏱️ 多周期分析（5、15、30 分钟）
• 🎯 结合成交量确认突破
• 📈 扩展目标（0.5x、1x、1.5x、2x）
• 🔍 检测 ORB 挤压
• 📡 分析交易倾向

🔍 公允价值缺口（FVG）检测

• 📊 识别三根蜡烛图形态
• 📈 多时间周期缺口分析（1m、5m、15m）
• 🎯 跟踪填补百分比和交互情况
• 💹 分析缺口形成期间的成交量
• 📐 统计填补概率
• 🎨 缺口强度分类

🚀 企业级功能

• ⚡ 采用 async/await 架构，性能出色
• 🔒 安全管理 API 密钥
• 🏗️ 模块化、可扩展设计
• 📝 全面的日志记录和错误处理
• 🧪 完整的测试覆盖
• 📋 全面使用类型提示

---

📖 API 参考

🎚️ financial_volume_profile

分析各价格水平的成交量分布，识别关键交易区域。

请求：

{
  "tool": "financial_volume_profile", 
  "symbol": "AAPL"
}

响应：

{
  "symbol": "AAPL",
  "status": "success",
  "timeframe_volume_profile": {
    "5m": {
      "volume_profile_structure": {
        "point_of_control": 150.25,
        "value_area_high": 151.80,
        "value_area_low": 149.10,
        "high_volume_nodes": [...],
        "low_volume_nodes": [...]
      },
      "volume_dynamics": {
        "supports_continued_upside": true,
        "volume_supports_upside_probability": 75.5,
        "volume_trend": "increasing",
        "volume_bias": "bullish"
      }
    }
  },
  "consolidated_analysis": {
    "supports_continued_upside": true,
    "confidence": "high"
  }
}

📈 financial_technical_analysis

提供涵盖多个时间周期的全面技术指标。

请求：

{
  "tool": "financial_technical_analysis",
  "symbol": "MSFT"
}

响应：

{
  "symbol": "MSFT", 
  "status": "success",
  "timeframe_indicators": {
    "1d": {
      "indicators": {
        "current_price": 380.50,
        "sma_20": 375.20,
        "sma_50": 370.15,
        "rsi": 65.2,
        "macd": {
          "macd": 2.34,
          "signal": 1.98,
          "histogram": 0.36
        },
        "atr": 8.45,
        "vwap": 379.80
      },
      "trend_analysis": {
        "trend": "uptrend",
        "strength": "moderate"
      }
    }
  }
}

🎯 financial_technical_zones

使用多种方法识别精确的支撑位和阻力位区域。

请求：

{
  "tool": "financial_technical_zones",
  "symbol": "GOOGL"  
}

响应：

{
  "symbol": "GOOGL",
  "status": "success", 
  "timeframe_zones": {
    "5m": {
      "zones": [
        {
          "type": "SUPPORT",
          "level": 142.50,
          "strength": "strong",
          "source": "Volume Profile POC",
          "confidence": 85
        },
        {
          "type": "RESISTANCE", 
          "level": 145.80,
          "strength": "moderate",
          "source": "Previous Day High",
          "confidence": 70
        }
      ]
    }
  }
}

📊 analyze_open_interest

分析开盘区间突破形态，为日内交易和 0DTE 交易策略提供支持。

请求：

{
  "tool": "analyze_open_interest",
  "symbol": "SPY"
}

响应：

{
  "symbol": "SPY",
  "status": "success",
  "timestamp": "2024-03-15T14:30:00Z",
  "market_session": "regular_hours",
  "current_price": 425.50,
  "orb_analysis": {
    "5min": {
      "orb_high": 424.75,
      "orb_low": 424.25,
      "orb_range": 0.50,
      "position": "above_range",
      "breakout_confirmed": true,
      "breakout_type": "bullish",
      "volume_analysis": {
        "volume_ratio_vs_day_avg": 1.35,
        "high_volume": true
      },
      "targets": {
        "bull_1x": 425.25,
        "bear_1x": 423.75
      },
      "targets_hit": ["bull_0.5x", "bull_1x"]
    }
  },
  "trading_bias": {
    "bias": "bullish",
    "confidence": "high",
    "strength_factors": [
      "5min bullish breakout confirmed",
      "5min high volume above range"
    ]
  },
  "orb_squeeze": {
    "squeeze_detected": false,
    "compression_ratio": 0.95
  }
}

🔍 financial_fvg_analysis

检测并分析多个时间框架中的公允价值缺口。

请求：

{
  "tool": "financial_fvg_analysis",
  "symbol": "AAPL"
}

响应：

{
  "symbol": "AAPL",
  "status": "success",
  "current_price": 195.50,
  "timeframe_data": {
    "1m": {
      "fvg_count": 3,
      "gaps": [
        {
          "gap_id": "1m_2024-12-01T14:15:00Z",
          "type": "bullish",
          "price_levels": {
            "gap_high": 195.80,
            "gap_low": 195.20,
            "gap_size": 0.60
          },
          "volume_data": {
            "candle_2_volume": 125000,
            "avg_volume_20_periods": 67000
          },
          "filled_percentage": 0.0,
          "age_minutes": 15
        }
      ]
    }
  },
  "nearest_gaps": {
    "above_current_price": [
      {"level": 196.10, "distance": 0.60, "timeframe": "1m"}
    ],
    "below_current_price": [
      {"level": 194.75, "distance": 0.75, "timeframe": "5m"}
    ]
  }
}

---

🎯 使用示例

基础分析

# Query: "Show me AAPL volume profile analysis"
# Response: Complete volume distribution with POC at $150.25

多工具分析

# Query: "Analyze TSLA using all technical tools and provide trading recommendation"
# Response: Comprehensive analysis with volume profile, indicators, and key zones

特定场景

# Scalping Setup
# Query: "Find 1-minute support levels for SPY for quick trades"

# Swing Trading
# Query: "Identify 5-minute resistance zones for NVDA breakout trading"

# Position Trading  
# Query: "Show daily technical analysis for QQQ trend confirmation"

# Mean Reversion
# Query: "Identify partially filled FVGs in NVDA that could complete filling"

# 0DTE Trading
# Query: "Analyze SPY ORB for 0DTE entry - is breakout confirmed?"

# FVG Trading
# Query: "Find unfilled gaps in TSLA for retracement entries"

---