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 许可证开源。
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.