# AkShare MCP 服务器

基于 AkShare 库的金融数据 MCP (Model Context Protocol) 服务器，提供全面的股票、基金、期货等金融数据查询功能。

## 功能特性

### 📈 股票市场数据
- **A股实时行情** - 沪深京A股实时行情数据
- **历史行情数据** - 支持日线、周线、月线，可复权
- **个股信息查询** - 基本面信息、财务数据
- **分时数据** - 分钟级K线数据
- **板块数据** - 新股、风险警示板等

### 🌏 多市场支持
- **A股市场** - 沪深京全市场覆盖
- **港股市场** - 港股数据支持
- **美股市场** - 美股实时行情（新浪财经）

### 📊 数据分析工具
- **同行比较** - 估值、成长性、财务指标对比
- **风险警示** - ST股票、退市股票信息
- **股市日历** - 公司动态、重要事件
- **技术指标** - 支持各类技术分析指标

## 安装设置

### 1. 环境要求
- Node.js >= 16
- Python >= 3.8
- akshare 库

### 2. 安装依赖

```bash
# 安装 Node.js 依赖
npm install

# 安装 Python akshare 库
pip install akshare pandas
```

### 3. 构建项目

```bash
npm run build
```

### 4. 配置 Claude Code

配置内容：
```json
{
  "mcpServers": {
    "akshare-mcp": {
      "command": "node",
      "args": ["/path/marketMcp/dist/index.js"],
    }
  }
}
```

### 5. 启动服务

```bash
npm start
```

### 6. 验证配置

重启 Claude Code 后，您就可以使用以下金融数据工具：
- A股实时行情查询
- 历史K线数据（支持复权）
- 个股基本信息查询
- 港股、美股数据
- 同行估值比较分析

## 可用工具

### 市场行情类

| 工具名 | 描述 | 参数 |
|--------|------|------|
| `stock_sh_a_spot_em` | 沪A股实时行情 | `limit` (可选) |
| `stock_sz_a_spot_em` | 深A股实时行情 | `limit` (可选) |

### 实时报价类（新增）

| 工具名 | 描述 | 参数 |
|--------|------|------|
| `stock_individual_spot_xq` | 个股实时行情数据（雪球） | `symbol` (必需) - 股票代码 |
| `realtime_quote` | 实时行情数据 | `symbol` (必需) - 支持多只股票，逗号分隔 |
| `stock_global_realtime` | 全球股市实时行情数据 | `region` (可选) - 地区：中国/香港/美国/欧洲/亚洲/全球 |
| `stock_hk_spot_em` | 港股实时行情数据 | `limit` (可选) - 数据条数限制 |
| `stock_us_spot` | 美股实时行情数据（新浪） | `symbol` (可选) - 支持多只股票，逗号分隔 |

### 历史数据类

| 工具名 | 描述 | 参数 |
|--------|------|------|
| `stock_zh_a_hist` | A股历史行情 | `symbol` (必需), `period`, `start_date`, `end_date`, `adjust` |
| `stock_zh_a_minute` | 分时数据 | `symbol` (必需), `period`, `adjust` |

### 个股信息类

| 工具名 | 描述 | 参数 |
|--------|------|------|
| `stock_individual_basic_info_xq` | 个股基本信息 | `symbol` (必需) |

### 市场分析类

| 工具名 | 描述 | 参数 |
|--------|------|------|
| `stock_gsrl_gsdt_em` | 股市日历公司动态 | `date` (必需) |

### 特殊板块类

| 工具名 | 描述 | 参数 |
|--------|------|------|
| `stock_zh_a_new_em` | 新股数据 | `limit` (可选) |
| `stock_zh_a_st_em` | 风险警示板数据 | `limit` (可选) |

## 使用示例

### 1. 获取A股实时行情

```json
{
  "tool": "stock_sh_a_spot_em",
  "arguments": {
    "limit": 10
  }
}
```

### 2. 查询个股历史行情

```json
{
  "tool": "stock_zh_a_hist",
  "arguments": {
    "symbol": "600246",
    "period": "daily",
    "start_date": "20241201",
    "end_date": "20241205",
    "adjust": "qfq"
  }
}
```

### 3. 获取个股基本信息

```json
{
  "tool": "stock_individual_basic_info_xq",
  "arguments": {
    "symbol": "600246"
  }
}
```

### 4. 获取个股实时行情（雪球）

```json
{
  "tool": "stock_individual_spot_xq",
  "arguments": {
    "symbol": "600246"
  }
}
```

### 5. 获取多只股票实时行情

```json
{
  "tool": "realtime_quote",
  "arguments": {
    "symbol": "600246,600000,000002"
  }
}
```

### 7. 获取全球股市实时行情

```json
{
  "tool": "stock_global_realtime",
  "arguments": {
    "region": "中国"
  }
}
```

### 8. 获取港股实时行情

```json
{
  "tool": "stock_hk_spot_em",
  "arguments": {
    "limit": 50
  }
}
```

### 9. 获取美股实时行情（新浪）

```json
{
  "tool": "stock_us_spot",
  "arguments": {
    "symbol": "AAPL,MSFT,GOOGL"
  }
}
```


## 测试

运行测试脚本验证服务功能：

```bash
npm test
```

或者直接运行：

```bash
node test/mcp-test.js
```

## 数据源

本服务器基于 [AkShare](https://github.com/akfamily/akshare) 库，数据来源于：
- 东方财富网
- 上海证券交易所
- 深圳证券交易所
- 新浪财经
- 腾讯财经
- 雪球财经

## 注意事项

1. **数据延迟**：实时行情数据可能有15分钟延迟
2. **访问频率**：请合理控制API调用频率，避免被限制
3. **免责声明**：本服务仅提供数据展示，不构成投资建议
4. **数据准确性**：请以官方数据为准，本数据仅供参考

## 故障排除

### 常见问题

1. **akshare库未安装**
```bash
pip install akshare pandas
```

2. **Python版本不兼容**
确保使用 Python 3.8+

3. **权限问题**
确保脚本有执行权限

4. **网络连接问题**
检查网络连接，某些数据源可能需要特殊网络环境

## 开发

### 项目结构
```
├── src/
│   └── index.ts          # MCP服务器主文件
├── test/
│   └── mcp-test.js       # 测试脚本
├── dist/                 # 编译输出目录
├── akshare_service.py    # Python服务脚本
├── package.json          # Node.js项目配置
├── tsconfig.json         # TypeScript配置
└── README.md            # 项目文档
```

### 添加新工具

1. 在 `src/index.ts` 中的 `getToolDefinitions` 方法中添加工具定义
2. Python服务会自动调用对应的akshare函数
3. 在 `test/mcp-test.js` 中添加相应的测试用例

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！

## 更新日志

### v1.0.0
- 初始版本发布
- 支持基础的股票数据查询功能
- 包含完整的测试套件