US Stock Data MCP Server
mingyaw
README
美股数据 MCP 服务器
一个用于访问和更新美股历史价格数据的模型上下文协议 (MCP) 服务器。
特性
- 本地数据存储:以 CSV 格式在本地存储股票数据,以便快速访问
- 自动更新:支持从 Yahoo Finance 自动更新股票数据
- 安全数据写入:使用临时文件以确保原子性和安全的数据写入
- 灵活的时间范围:可自定义数据更新的起始日期
安装
- 确保已安装 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
: 股票代码
数据格式
存储的股票数据包括以下字段:
- Date: 交易日期
- Open: 开盘价
- High: 最高价
- Low: 最低价
- Close: 收盘价
- Volume: 交易量
依赖项
- mcp: MCP 协议实现
- pandas: 数据处理和分析
- yfinance: Yahoo Finance 数据检索
- pydantic: 数据验证和设置管理
注意事项
- 更新期间会自动处理重复数据,保留最新记录
- 在更新操作之间实施 5 秒延迟,以避免频繁的 API 请求
- 所有数据操作都包含错误处理,以确保服务稳定性
推荐服务器
Crypto Price & Market Analysis MCP Server
一个模型上下文协议 (MCP) 服务器,它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器,利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面,提供实时价格数据、市场分析以及历史趋势数据。
MCP PubMed Search
用于搜索 PubMed 的服务器(PubMed 是一个免费的在线数据库,用户可以在其中搜索生物医学和生命科学文献)。 我是在 MCP 发布当天创建的,但当时正在度假。 我看到有人在您的数据库中发布了类似的服务器,但还是决定发布我的服务器。
mixpanel
连接到您的 Mixpanel 数据。 从 Mixpanel 分析查询事件、留存和漏斗数据。

Sequential Thinking MCP Server
这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

Nefino MCP Server
为大型语言模型提供访问德国可再生能源项目新闻和信息的能力,允许按地点、主题(太阳能、风能、氢能)和日期范围进行筛选。
Vectorize
将 MCP 服务器向量化以实现高级检索、私有深度研究、Anything-to-Markdown 文件提取和文本分块。
Mathematica Documentation MCP server
一个服务器,通过 FastMCP 提供对 Mathematica 文档的访问,使用户能够从 Wolfram Mathematica 检索函数文档和列出软件包符号。
kb-mcp-server
一个 MCP 服务器,旨在实现便携性、本地化、简易性和便利性,以支持对 txtai “all in one” 嵌入数据库进行基于语义/图的检索。任何 tar.gz 格式的 txtai 嵌入数据库都可以被加载。
Research MCP Server
这个服务器用作 MCP 服务器,与 Notion 交互以检索和创建调查数据,并与 Claude Desktop Client 集成以进行和审查调查。

Cryo MCP Server
一个API服务器,实现了模型补全协议(MCP),用于Cryo区块链数据提取,允许用户通过任何兼容MCP的客户端查询以太坊区块链数据。