# Stock Data MCP Server

[English](README_EN.md) | 中文

MCP 服务器，提供 A股/港股/美股、加密货币数据查询，支持多数据源自动故障转移。

## 安装

###  PyPI 

- MCP 配置

```json
{
  "mcpServers": {
    "stock-data": {
      "command": "uvx",
      "args": ["stock-data-mcp"]
    }
  }
}
```

### Docker
```
docker run -p 8808:8808 ghcr.io/stockmcp/stock-data-mcp
```

- MCP 配置

```json
{
  "mcpServers": {
    "stock-data": {
      "url": "http://0.0.0.0:8808/mcp" # Streamable HTTP
    }
  }
}
```

###  Git 源码(开发版，会实时更新)

- MCP 配置

```json
{
  "mcpServers": {
    "stock-data": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/stockmcp/stock-data-mcp",
        "stock-data-mcp"
      ]
    }
  }
}
```

<details>
<summary>环境变量（可选）</summary>

| 变量 | 说明 |
|------|------|
| `TUSHARE_TOKEN` | Tushare Pro API Token（A股高优先数据源） |
| `ALPHA_VANTAGE_API_KEY` | Alpha Vantage API Key（美股数据增强，不配置则使用 yfinance 免费源） |
| `OKX_BASE_URL` | OKX API 代理地址 |
| `BINANCE_BASE_URL` | Binance API 代理地址 |
| `NEWSNOW_CHANNELS` | NewsNow 财经快讯频道列表（默认：`wallstreetcn-quick,cls-telegraph,jin10`） |

</details>

## Claude Code

```
claude mcp add stock-data \
    -e TUSHARE_TOKEN=your_token \
    -e ALPHA_VANTAGE_API_KEY=your_key \
    -e OKX_BASE_URL=https://okx.4url.cn\
    -e BINANCE_BASE_URL=https://bian.4url.cn \
    -- uvx stock-data-mcp
```

## 工具列表

| 工具 | 说明 |
|------|------|
| `search` | 股票搜索 |
| `stock_info` | 股票信息 |
| `stock_prices` | 历史价格+技术指标 |
| `stock_realtime` | 实时行情 |
| `stock_batch_realtime` | 批量实时行情 |
| `stock_chip` | 筹码分布 |
| `stock_fund_flow` | 个股资金流向 |
| `stock_period_stats` | 多周期统计 |
| `stock_sector_spot` | 个股所属板块 |
| `stock_board_cons` | 板块成分股 |
| `stock_news` | 个股新闻 |
| `stock_news_global` | 全球财经快讯 |
| `stock_indicators_a` | A股财务指标 |
| `stock_indicators_hk` | 港股财务指标 |
| `stock_indicators_us` | 美股财务指标 |
| `stock_zt_pool_em` | A股涨停股池 |
| `stock_zt_pool_strong_em` | A股强势股池 |
| `stock_lhb_ggtj_sina` | A股龙虎榜 |
| `stock_sector_fund_flow_rank` | 板块资金流 |
| `stock_overview_us` | 美股公司概览（Alpha Vantage / yfinance） |
| `stock_financials_us` | 美股财务报表（Alpha Vantage / yfinance） |
| `stock_news_us` | 美股新闻情绪（需 Alpha Vantage API key） |
| `stock_earnings_us` | 美股盈利数据（Alpha Vantage / yfinance） |
| `stock_insider_us` | 美股内部交易（Alpha Vantage / yfinance） |
| `stock_tech_indicators_us` | 美股技术指标（需 Alpha Vantage API key） |
| `okx_prices` | 加密货币K线 |
| `okx_loan_ratios` | 加密货币借贷比 |
| `okx_taker_volume` | 加密货币买卖量 |
| `binance_ai_report` | 加密货币AI分析 |
| `get_current_time` | 系统时间及交易日 |
| `data_source_status` | 数据源状态 |

## License

MIT