美国股票数据 MCP 服务

一个专为访问和更新美国股票历史价格数据设计的模型上下文协议（MCP）服务器。

功能特点

• 本地数据存储：以 CSV 格式本地存储股票数据，实现快速访问
• 自动更新：支持从雅虎财经自动获取股票数据
• 安全写入数据：使用临时文件确保数据写入的原子性和安全性
• 灵活的时间范围：可自定义数据更新的起始日期

安装指南

1. 确保已安装 Python 3.x
2. 克隆此仓库
3. 安装依赖项：

pip install -r requirements.txt

使用说明

1. 启动服务器

python server.py

默认数据存储路径为启动后：~/Library/Application Support/us-market-data/data

您可以通过 US_STOCK_DATA_DIR 环境变量自定义数据存储路径。

2. 可用功能

MCP 工具

1. 获取本地股票数据 (get_local_stock_data)

   • 功能：检索本地股票历史数据
   • 参数：
     • symbol：股票代码，例如 'AAPL'、'MSFT'

2. 更新股票数据 (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：数据验证和设置管理

注意事项

1. 更新过程中会自动处理重复数据，保留最新记录
2. 实现了 5 秒的延迟以避免频繁的 API 请求
3. 所有数据操作均包含错误处理，确保服务稳定性