🚀 股票数据MCP服务器
本服务器利用模型上下文协议（Model Context Protocol, MCP）实现股票市场数据的查询功能。它能够为Claude Desktop等支持MCP的客户端提供实时股票信息以及日期/时间信息。
🚀 快速开始
本服务器借助MCP协议，可让你轻松查询股票市场数据，为你提供实时股票信息和日期/时间信息。
✨ 主要特性
1. 股票价格数据查询
- 可查询特定时间段内的股票价格数据。
- 能够灵活指定开始日期和结束日期。
- 若未指定日期，则以当前日期为基准进行查询。
2. 股票信息查询
- 提供公司名称、行业板块、所属产业等基本信息。
- 提供市值、股价等财务相关信息。
- 提供公司概况及说明。
3. 当前日期/时间信息
- 提供适应不同时区的当前日期和时间信息。
- 支持以多种格式提供日期/时间数据（如ISO格式、韩语格式、Unix时间戳等）。
📦 安装指南
必备要求
- Python 3.10及以上版本。
- 需要安装MCP库。
Mac/Linux安装步骤
- 安装MCP包：
pip install mcp
- 启动MCP服务器：
mcp-server start
Windows安装步骤
- 安装Python并打开命令提示符。
- 安装MCP包：
pip install mcp
- 启动MCP服务器：
mcp-server start
💻 使用示例
开发与测试示例
你可以使用MCP服务器开发新的应用程序，或者将其与现有应用程序集成。以下示例展示了如何通过MCP搜索股票数据：
from mcp import MCPClient
client = MCPClient()
response = client.request('stock://AAPL/overview')
print(response)
Claude Desktop使用示例
1. 实时股价查询
! stock {symbol} price- 示例：
! stock AAPL price
- 示例：
2. 股票信息查询
! stock {symbol} info- 示例：
! stock MSFT info
- 示例：
3. 时区当前时间查询
! time {timezone}- 示例：
! time Asia/Seoul
- 示例：
📚 详细文档
股票概况资源 (stock://{symbol}/overview)
以Markdown格式提供股票的基本信息。
⚠️ 注意事项
⚠️ 重要提示
- yfinance库使用非官方API，因此可能会因Yahoo Finance服务条款的变更而停止工作。
- 由于是免费API，当请求频率过高时可能会受到限制。
- 数据可能会比实时数据稍有延迟。
📄 许可证
本项目采用MIT许可证。