美国股票数据MCP服务器
一种模型上下文协议（MCP）服务器，用于访问和更新美国股票历史价格数据。
特性
- 本地数据存储：以CSV格式在本地存储股票数据，以便快速访问
- 自动更新：支持雅虎财经自动更新股票数据
- 安全数据写入：使用临时文件确保原子和安全的数据写入
- 灵活的时间范围：可自定义数据更新的开始日期
安装
- 确保已安装Python 3.x
- 克隆此存储库
- 安装依赖项：
pip install -r requirements.txt用法
1.启动服务器
python server.py服务器启动后的默认数据存储路径为： ~/Library/Application Support/us-market-data/data
您可以使用自定义数据存储路径 US_STOCK_DATA_DIR 环境变量。
2.可用功能
MCP工具
get_local_stock_data
- 功能：检索本地股票历史数据 - 参数： - symbol：股票代码，例如“AAPL”、“MSFT”
update_stock_data
- 功能：更新库存数据 - 参数： - symbol：股票代码，例如“AAPL”、“MSFT” - start_date：开始日期采用YYYY-MM-DD格式，默认为2015-01-01
MCP资源
- 资源URI:
usstock://{symbol}/historical
- 功能：提供美国本地股票历史价格数据 - 参数： - symbol：股票代码
数据格式
存储的库存数据包括以下字段：
- 日期：交易日期
- 开盘价：开盘价
- 高：最高价格
- 低：最低价格
- 收盘价：收盘价
- 交易量：交易量
依赖项
- mcp:mcp协议实现
- pandas：数据处理和分析
- yfinance：雅虎财经数据检索
- pydantic：数据验证和设置管理
备注
- 更新过程中会自动处理重复数据，保留最新记录
- 在更新操作之间实现5秒延迟，以避免频繁的API请求
- 所有数据操作都包括错误处理，以确保服务稳定性