US Stock Data MCP Server
2025.03.28
0
Python股票数据金融分析金融服务
US Stock Data MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门用于访问和更新美国股票的历史价格数据。它提供了本地数据存储、自动更新、安全数据写入和灵活的时间范围设置等功能，适用于需要处理和分析美国股票数据的场景。
View on GitHub
Overview
基本能力
产品定位
US Stock Data MCP Server 是一个专门用于处理美国股票历史价格数据的服务，提供数据存储、更新和查询功能。
核心功能
- 本地数据存储：将股票数据以 CSV 格式存储在本地，便于快速访问。
- 自动更新：支持从 Yahoo Finance 自动更新股票数据。
- 安全数据写入：使用临时文件确保数据的原子性和安全性。
- 灵活的时间范围：可自定义数据更新的起始日期。
适用场景
- 需要本地存储和快速访问美国股票历史数据的应用。
- 需要定期更新股票数据的自动化系统。
- 需要安全写入和查询股票数据的金融分析工具。
工具列表
- get_local_stock_data
- 功能：检索本地股票历史数据。
- 参数：
symbol（股票代码，如 'AAPL', 'MSFT'）。 - update_stock_data
- 功能：更新股票数据。
- 参数：
symbol（股票代码），start_date（起始日期，格式为 YYYY-MM-DD，默认为 2015-01-01）。
常见问题解答
- 数据重复处理：更新时会自动处理重复数据，保留最新记录。
- 更新频率限制：更新操作之间有 5 秒的延迟，以避免频繁的 API 请求。
- 错误处理：所有数据操作都包含错误处理，确保服务稳定性。
使用教程
使用依赖
- 确保已安装 Python 3.x。
- 安装依赖：
pip install -r requirements.txt
安装教程
- 克隆仓库。
- 安装依赖（如上所述）。
- 启动服务：
python server.py
调试方式
- 启动服务后，默认数据存储路径为：
~/Library/Application Support/us-market-data/data。 - 可以通过设置
US_STOCK_DATA_DIR环境变量来自定义数据存储路径。