mg-mcp-server/ALPHA-VANTAGE-FEATURES.md

MCP server for financial data APIs (Alpha Vantage + Yahoo Finance)

# Alpha Vantage API 功能对比

## 当前项目实现的功能（免费版）

### ✅ 已实现的免费API功能

#### 1. 股票数据
- **实时报价** (`GLOBAL_QUOTE`)
  - 工具：`get_stock_quote`
  - 限制：免费版可用
  
- **历史股价数据**
  - `TIME_SERIES_DAILY` - 工具：`get_stock_daily`
  - `TIME_SERIES_INTRADAY` - 工具：`get_stock_intraday`
  - `TIME_SERIES_WEEKLY` - 工具：`get_stock_weekly`
  - `TIME_SERIES_MONTHLY` - 工具：`get_stock_monthly`
  - 限制：免费版可用，但有数据量限制

#### 2. 外汇数据
- **汇率查询** (`CURRENCY_EXCHANGE_RATE`)
  - 工具：`get_exchange_rate`
  - 限制：免费版可用

#### 3. 加密货币
- **数字货币日线数据** (`DIGITAL_CURRENCY_DAILY`)
  - 工具：`get_crypto_daily`
  - 限制：免费版可用

#### 4. 技术指标
- **简单移动平均线** (`SMA`) - 工具：`get_sma`
- **相对强弱指数** (`RSI`) - 工具：`get_rsi`
- **MACD指标** (`MACD`) - 工具：`get_macd`
- 限制：免费版可用

#### 5. 新闻情绪分析
- **新闻情绪** (`NEWS_SENTIMENT`)
  - 工具：`get_news_sentiment`
  - 限制：免费版可用，但有数量限制

### 📊 免费版限制
- **速率限制**：5 calls/minute, 500 calls/day
- **数据延迟**：实时数据可能有15-20分钟延迟
- **历史数据**：有限的历史数据范围

## 🚀 付费版额外功能

### Premium Plan ($49.99/月)

#### 1. 增强的股票数据
- **实时数据**：真正的实时股价，无延迟
- **更多历史数据**：完整的历史数据集
- **盘前盘后交易数据**：扩展交易时间数据
- **股票分割和股息调整**：自动调整的价格数据

#### 2. 基本面数据 📈
- **公司概况** (`OVERVIEW`)
  - 公司基本信息、财务比率
  - 市值、P/E比率、EPS等
  
- **收益报告** (`EARNINGS`)
  - 季度和年度收益数据
  - EPS预期vs实际
  
- **现金流报表** (`CASH_FLOW`)
  - 经营、投资、融资现金流
  
- **资产负债表** (`BALANCE_SHEET`)
  - 资产、负债、股东权益
  
- **利润表** (`INCOME_STATEMENT`)
  - 收入、支出、净利润

#### 3. 高级技术指标
- **布林带** (`BBANDS`)
- **随机指标** (`STOCH`)
- **威廉指标** (`WILLR`)
- **平均方向指数** (`ADX`)
- **商品通道指数** (`CCI`)
- **抛物线SAR** (`SAR`)
- **平均真实波幅** (`ATR`)
- **动量指标** (`MOM`)
- **变化率** (`ROC`)

#### 4. 外汇增强功能
- **实时外汇汇率**：无延迟
- **外汇历史数据**：完整历史
- **外汇技术指标**：专门的外汇分析工具

#### 5. 加密货币增强
- **实时加密货币价格**
- **更多加密货币对**
- **加密货币技术指标**

### Enterprise Plan ($249.99/月)

#### 1. 更高的API限制
- **速率限制**：1200 calls/minute
- **无日限制**：无每日调用限制

#### 2. 独家数据集
- **期权数据**：期权链、隐含波动率
- **ETF数据**：ETF持仓、表现
- **共同基金数据**：基金净值、持仓
- **经济指标**：GDP、通胀率、失业率等宏观数据

#### 3. 高级分析工具
- **投资组合分析**
- **风险管理指标**
- **相关性分析**
- **回测功能**

## 🛠️ 建议的扩展实现

### 可以添加的付费功能（如果用户升级）

```typescript
// 基本面数据工具
async getCompanyOverview(symbol: string): Promise<AlphaVantageResponse> {
  return this.makeRequest({
    function: 'OVERVIEW',
    symbol: symbol.toUpperCase(),
  });
}

async getEarnings(symbol: string): Promise<AlphaVantageResponse> {
  return this.makeRequest({
    function: 'EARNINGS',
    symbol: symbol.toUpperCase(),
  });
}

async getCashFlow(symbol: string): Promise<AlphaVantageResponse> {
  return this.makeRequest({
    function: 'CASH_FLOW',
    symbol: symbol.toUpperCase(),
  });
}

// 高级技术指标
async getBollingerBands(symbol: string, interval: string = 'daily', timePeriod: string = '20'): Promise<AlphaVantageResponse> {
  return this.getTechnicalIndicator(symbol, 'BBANDS', interval, timePeriod);
}

async getStochastic(symbol: string, interval: string = 'daily'): Promise<AlphaVantageResponse> {
  return this.getTechnicalIndicator(symbol, 'STOCH', interval);
}
```

## 💡 升级建议

### 何时考虑升级到付费版
1. **需要实时数据**：交易应用需要无延迟数据
2. **基本面分析**：需要财务报表和公司基本信息
3. **高频调用**：超过免费版的速率限制
4. **专业分析**：需要高级技术指标和分析工具

### 成本效益分析
- **Premium ($49.99/月)**：适合个人投资者和小型应用
- **Enterprise ($249.99/月)**：适合专业交易平台和大型应用

## 📋 总结

当前项目实现了Alpha Vantage免费版的核心功能，足以满足基本的股票分析需求。付费版主要提供：
1. 实时数据（无延迟）
2. 基本面财务数据
3. 高级技术指标
4. 更高的API调用限制
5. 独家数据集（期权、ETF、经济指标）

对于大多数用户，免费版已经足够。如需升级，建议根据具体需求选择合适的付费计划。