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 表格,包含以下信息:
美股/港股输出格式
A股输出格式
安装依赖
启动服务器
方法一:直接运行主文件
方法二:使用启动脚本
环境变量配置
可以通过环境变量自定义服务器配置:
客户端连接配置
在您的 MCP 客户端中添加以下配置:
使用示例
启动服务器后,您可以通过 MCP 客户端调用各种工具:
美股数据示例
港股数据示例
A股数据示例
日志
服务器日志会保存在 logs/akshare_mcp.log 文件中,包含详细的操作记录和错误信息。
项目结构
注意事项
确保网络连接正常,AkShare 需要访问外部数据源
某些接口可能有访问频率限制,请适当控制调用频率
数据仅供参考,投资决策请谨慎
许可证
本项目基于 MIT 许可证开源。