AkShare MCP 服务器
基于 FastMCP 2.0 和 SSE 协议的 AkShare 金融数据 MCP 服务器。
功能特性
- 🚀 基于 SSE 协议，零依赖、即开即用
- 📊 集成 AkShare 金融数据接口
- 📋 Markdown 表格格式输出，美观易读
- 🔧 支持环境变量配置
- 📝 完整的日志记录
- 🛡️ 参数验证和错误处理
已实现的工具
stock_us_hist - 美股历史行情数据
获取美股历史行情数据，支持不同周期和复权方式。
参数：
symbol: 美股代码，例如 '106.TTE' 或 'AAPL'period: 数据周期，选择 {'daily', 'weekly', 'monthly'}，默认 'daily'start_date: 开始日期，格式 YYYYMMDD，默认 '20210101'end_date: 结束日期，格式 YYYYMMDD，默认 '20240214'adjust: 复权类型，''=未复权, 'qfq'=前复权, 'hfq'=后复权，默认 ''
返回数据：
- 日期、开盘、收盘、最高、最低价格（美元）
- 成交量（股）、成交额（美元）
- 振幅、涨跌幅、涨跌额、换手率
stock_hk_hist - 港股历史行情数据
获取港股历史行情数据，支持不同周期和复权方式。
参数：
symbol: 港股代码，例如 '00593' 或 '08367'period: 数据周期，选择 {'daily', 'weekly', 'monthly'}，默认 'daily'start_date: 开始日期，格式 YYYYMMDD，默认 '19700101'end_date: 结束日期，格式 YYYYMMDD，默认 '22220101'adjust: 复权类型，''=未复权, 'qfq'=前复权, 'hfq'=后复权，默认 ''
返回数据：
- 日期、开盘、收盘、最高、最低价格（港元）
- 成交量（股）、成交额（港元）
- 振幅、涨跌幅、涨跌额、换手率
stock_zh_a_hist - A股历史行情数据
获取沪深京A股历史行情数据，支持不同周期和复权方式。
参数：
symbol: A股代码，例如 '000001'(平安银行) 或 '603777'period: 数据周期，选择 {'daily', 'weekly', 'monthly'}，默认 'daily'start_date: 开始日期，格式 YYYYMMDD，默认 '20210301'end_date: 结束日期，格式 YYYYMMDD，默认 '20240528'adjust: 复权类型，''=不复权, 'qfq'=前复权, 'hfq'=后复权，默认 ''
返回数据：
- 日期、股票代码、开盘、收盘、最高、最低价格（人民币）
- 成交量（手，1手=100股）、成交额（元）
- 振幅、涨跌幅、涨跌额、换手率
复权说明：
- 前复权：保持当前价格不变，调整历史价格，适合技术分析
- 后复权：保证历史价格不变，调整当前价格，适合量化研究
输出格式示例
所有工具都返回格式化的 Markdown 表格，包含以下信息：
美股/港股输出格式
# 美股历史行情数据
**股票代码**: AAPL
**数据周期**: daily
**日期范围**: 20240101 ~ 20240214
**复权方式**: 前复权
**数据条数**: 32 条
**货币单位**: 美元 (USD)
| 日期 | 开盘 | 收盘 | 最高 | 最低 | 成交量 | 成交额 | 振幅 | 涨跌幅 | 涨跌额 | 换手率 |
|------------|--------|--------|--------|--------|-----------|-------------|-------|--------|--------|--------|
| 2024-01-02 | 187.15 | 185.64 | 187.90 | 182.73 | 52230000 | 9687420000 | 2.76 | -2.94 | -5.61 | 0.84 |
| 2024-01-03 | 184.22 | 184.25 | 185.88 | 183.43 | 47317000 | 8732510000 | 1.32 | -0.75 | -1.39 | 0.76 |
*数据来源：东方财富网*
A股输出格式
# A股历史行情数据
**股票代码**: 000001
**数据周期**: daily
**日期范围**: 20240101 ~ 20240528
**复权方式**: 前复权
**数据条数**: 95 条
**货币单位**: 人民币 (CNY)
**成交量单位**: 手 (1手=100股)
| 日期 | 股票代码 | 开盘 | 收盘 | 最高 | 最低 | 成交量 | 成交额 | 振幅 | 涨跌幅 | 涨跌额 | 换手率 |
|------------|----------|-------|-------|-------|-------|---------|-------------|-------|--------|--------|--------|
| 2024-01-02 | 000001 | 11.88 | 11.78 | 11.96 | 11.72 | 1052468 | 1241250000 | 2.03 | -0.84 | -0.10 | 0.38 |
| 2024-01-03 | 000001 | 11.74 | 11.65 | 11.80 | 11.58 | 892456 | 1042180000 | 1.87 | -1.10 | -0.13 | 0.32 |
*数据来源：东方财富网*
*注：成交量单位为手，成交额单位为元*
安装依赖
pip install -r requirements.txt
启动服务器
方法一：直接运行主文件
python akshare_mcp_server.py
方法二：使用启动脚本
python start_server.py
环境变量配置
可以通过环境变量自定义服务器配置：
export HOST=127.0.0.1
export PORT=8005
export TRANSPORT=sse
客户端连接配置
在您的 MCP 客户端中添加以下配置：
{
"mcpServers": {
"akshare-mcp": {
"type": "sse",
"url": "http://127.0.0.1:8005/sse",
"timeout": 60,
"description": "AkShare金融数据MCP服务器"
}
}
}
使用示例
启动服务器后，您可以通过 MCP 客户端调用各种工具：
美股数据示例
获取苹果公司(AAPL)近期股价数据：
- symbol: "AAPL"
- period: "daily"
- start_date: "20240101"
- end_date: "20240214"
- adjust: "qfq"
港股数据示例
获取腾讯控股(00700)港股数据：
- symbol: "00700"
- period: "daily"
- start_date: "20240101"
- end_date: "20240214"
- adjust: "qfq"
A股数据示例
获取平安银行(000001)A股数据：
- symbol: "000001"
- period: "daily"
- start_date: "20240101"
- end_date: "20240528"
- adjust: "qfq"
日志
服务器日志会保存在 logs/akshare_mcp.log 文件中，包含详细的操作记录和错误信息。
项目结构
Ptrader-MCP/
├── akshare_mcp_server.py # 主服务器文件
├── start_server.py # 启动脚本
├── config.json # 客户端连接配置
├── requirements.txt # 依赖文件
├── README.md # 使用说明
└── logs/ # 日志目录
注意事项
- 确保网络连接正常，AkShare 需要访问外部数据源
- 某些接口可能有访问频率限制，请适当控制调用频率
- 数据仅供参考，投资决策请谨慎
许可证
本项目基于 MIT 许可证开源。