US Stock Data MCP Server

美股数据 MCP 服务

这是一个 Model Context Protocol（MCP）服务，旨在访问和更新美股历史价格数据。

功能

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

安装

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：股票代码

数据格式

存储的股票数据包含以下字段：

• Date：交易日期
• Open：开盘价
• High：最高价
• Low：最低价
• Close：收盘价
• Volume：交易量

依赖项

• mcp：MCP 协议实现
• pandas：数据处理与分析
• yfinance：Yahoo Finance 数据获取
• pydantic：数据验证与设置管理

注意事项

1. 更新时会自动处理重复数据，并保留最新记录
2. 更新操作之间会间隔 5 秒，以避免频繁请求 API
3. 所有数据操作均包含错误处理，以确保服务稳定性