Akshare

AkShare MCP 服务器基于 FastMCP 2.0 和 SSE 协议，提供对 AkShare 金融数据接口的封装，通过 MCP 客户端即可请求不同市场的数据。服务器实现了美股、港股和 A 股历史行情数据工具，输出格式为美观的 Markdown 表格，便于直接展示和记录。启动后，您可以通过客户端配置连接到 http://HOST:PORT/sse，调用 stock_us_hist、stock_hk_hist、stock_zh_a_hist 等工具，指定参数如 symbol、period、start_date、end_date 与 adjust，获取相应周期、复权方式与数据范围的历史行情数据，以及相关的成交量、成交额和股市指标信息。日志会记录请求、错误和运行状态，便于排错与审计。

Prerequisites:

• 安装 Python 3.8 及以上
• 具备网络访问外部数据源的能力（AkShare 调用的数据源可能需要网络访问）

安装步骤:

1. 克隆或下载仓库到本地
2. 进入项目目录
3. 安装依赖

pip install -r requirements.txt

4. 启动服务器

# 方法：直接运行主服务器文件
python akshare_mcp_server.py

# 或方法：使用启动脚本（如果提供）
python start_server.py

5. 通过客户端连接配置进行调用，默认环境变量可覆盖监听地址、端口与传输协议。

注意事项与提示:

• 在环境中配置 HOST、PORT、TRANSPORT 以适配您的部署环境，例如容器化部署时通常使用 0.0.0.0:8005 作为对外暴露端口。
• AkShare 需要访问外部数据源，请确保网络正常且接口未被频繁限速。
• 输出为 Markdown 表格格式，适合直接在文档或终端中展示。若受限于客户端格式，请在调用时对返回数据进行再格式化。
• 日志文件通常保存在日志目录（如 logs/akshare_mcp.log），如出现错误请检查日志以定位请求或数据源问题。
• 如需扩展工具，可在 akshare_mcp_server.py 中增添新的 AkShare 接口封装，遵循现有的参数/返回格式。