AkShare MCP 服务器
基于 AkShare 库的金融数据 MCP (Model Context Protocol) 服务器，提供全面的股票、基金、期货等金融数据查询功能。
功能特性
📈 股票市场数据
- A股实时行情 - 沪深京A股实时行情数据
- 历史行情数据 - 支持日线、周线、月线，可复权
- 个股信息查询 - 基本面信息、财务数据
- 分时数据 - 分钟级K线数据
- 板块数据 - 新股、风险警示板等
🌏 多市场支持
- A股市场 - 沪深京全市场覆盖
- 港股市场 - 港股数据支持
- 美股市场 - 美股实时行情（新浪财经）
📊 数据分析工具
- 同行比较 - 估值、成长性、财务指标对比
- 风险警示 - ST股票、退市股票信息
- 股市日历 - 公司动态、重要事件
- 技术指标 - 支持各类技术分析指标
安装设置
1. 环境要求
- Node.js >= 16
- Python >= 3.8
- akshare 库
2. 安装依赖
# 安装 Node.js 依赖
npm install
# 安装 Python akshare 库
pip install akshare pandas
3. 构建项目
npm run build
4. 配置 Claude Code
配置内容：
{
"mcpServers": {
"akshare-mcp": {
"command": "node",
"args": ["/path/marketMcp/dist/index.js"],
}
}
}
5. 启动服务
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股实时行情
{
"tool": "stock_sh_a_spot_em",
"arguments": {
"limit": 10
}
}
2. 查询个股历史行情
{
"tool": "stock_zh_a_hist",
"arguments": {
"symbol": "600246",
"period": "daily",
"start_date": "20241201",
"end_date": "20241205",
"adjust": "qfq"
}
}
3. 获取个股基本信息
{
"tool": "stock_individual_basic_info_xq",
"arguments": {
"symbol": "600246"
}
}
4. 获取个股实时行情（雪球）
{
"tool": "stock_individual_spot_xq",
"arguments": {
"symbol": "600246"
}
}
5. 获取多只股票实时行情
{
"tool": "realtime_quote",
"arguments": {
"symbol": "600246,600000,000002"
}
}
7. 获取全球股市实时行情
{
"tool": "stock_global_realtime",
"arguments": {
"region": "中国"
}
}
8. 获取港股实时行情
{
"tool": "stock_hk_spot_em",
"arguments": {
"limit": 50
}
}
9. 获取美股实时行情（新浪）
{
"tool": "stock_us_spot",
"arguments": {
"symbol": "AAPL,MSFT,GOOGL"
}
}
测试
运行测试脚本验证服务功能：
npm test
或者直接运行：
node test/mcp-test.js
数据源
本服务器基于 AkShare 库，数据来源于：
- 东方财富网
- 上海证券交易所
- 深圳证券交易所
- 新浪财经
- 腾讯财经
- 雪球财经
注意事项
- 数据延迟：实时行情数据可能有15分钟延迟
- 访问频率：请合理控制API调用频率，避免被限制
- 免责声明：本服务仅提供数据展示，不构成投资建议
- 数据准确性：请以官方数据为准，本数据仅供参考
故障排除
常见问题
- akshare库未安装
pip install akshare pandas
-
Python版本不兼容 确保使用 Python 3.8+
-
权限问题 确保脚本有执行权限
-
网络连接问题 检查网络连接，某些数据源可能需要特殊网络环境
开发
项目结构
├── src/
│ └── index.ts # MCP服务器主文件
├── test/
│ └── mcp-test.js # 测试脚本
├── dist/ # 编译输出目录
├── akshare_service.py # Python服务脚本
├── package.json # Node.js项目配置
├── tsconfig.json # TypeScript配置
└── README.md # 项目文档
添加新工具
- 在
src/index.ts中的getToolDefinitions方法中添加工具定义 - Python服务会自动调用对应的akshare函数
- 在
test/mcp-test.js中添加相应的测试用例
许可证
MIT License
贡献
欢迎提交 Issue 和 Pull Request！
更新日志
v1.0.0
- 初始版本发布
- 支持基础的股票数据查询功能
- 包含完整的测试套件