# 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
- 初始版本发布
- 支持基础的股票数据查询功能
- 包含完整的测试套件
