Us Stock MCP Server

🚀 美国股票数据 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 工具

• 获取本地股票数据 (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 请求。
• 所有数据操作均包含错误处理，确保服务稳定性。

⚠️ 重要提示

本服务在更新数据时会自动处理重复数据，保留最新记录。同时，为避免频繁的 API 请求，实现了 5 秒的延迟。

💡 使用建议

您可以通过 US_STOCK_DATA_DIR 环境变量自定义数据存储路径，以满足不同的使用需求。