MCP Stock Market Analysis
2025.03.27
0
Python股票市场分析金融数据服务金融服务
MCP Stock Market Analysis 是一个强大的股票市场分析应用程序，利用 AlphaVantage API 提供实时股票数据和技术分析。该应用程序集成了模型上下文协议（MCP），使 AI 助手能够访问股票市场数据和分析。
View on GitHub
Overview
基本能力
产品定位
MCP Stock Market Analysis 是一个专注于股票市场数据获取和分析的工具，旨在为 AI 助手和开发者提供实时股票数据和技术分析能力。
核心功能
- 实时股票报价：获取最新的股票价格和交易信息
- 技术分析：计算和可视化关键指标，如 RSI 和移动平均线
- MCP 集成：通过模型上下文协议与 AI 助手无缝集成
- REST API：提供 FastAPI 端点以编程方式访问股票数据
- 交互式仪表盘：基于 Streamlit 的可视化仪表盘
适用场景
- AI 助手需要获取股票市场数据
- 开发者需要构建股票市场分析工具
- 投资者需要实时监控股票表现
MCP 工具列表
| 工具 | 描述 | 参数 |
|---|---|---|
get_stock_quote |
获取最新的股票报价 | symbol: 股票代码 (例如 AAPL) |
analyze_stock |
获取带有技术指标的详细股票分析 | symbol: 股票代码 (例如 AAPL) |
常见问题解答
- API 密钥问题：确保您的 AlphaVantage API 密钥正确设置在
.env文件中 - 端口冲突：如果出现“地址已在使用”错误，请确保没有其他应用程序使用端口 8000、8080 或 8501
- 速率限制：AlphaVantage 的免费层有使用限制。如果遇到错误，可能是超出了这些限制
使用教程
使用依赖
- Python 3.12 或更高版本
- AlphaVantage API Key（免费层可用）
- Git
安装教程
-
克隆仓库
bash git clone https://github.com/yourusername/mcp-stock-market-analysis.git cd mcp-stock-market-analysis -
创建并激活虚拟环境
- Windows:
bash python -m venv venv venv\Scripts\activate -
macOS/Linux:
bash python -m venv venv source venv/bin/activate -
安装依赖
- 使用 pip:
bash pip install -e . -
或使用 uv (更快):
bash pip install uv uv install -
设置环境变量 在项目根目录创建
.env文件，并添加您的 AlphaVantage API 密钥:ALPHA_VANTAGE_API_KEY=your_api_key_here
调试方式
- 运行完整应用程序
bash python server.py这将启动: - FastAPI 服务器在 http://localhost:8000
- MCP 服务器在 http://localhost:8080
-
Streamlit 仪表盘在 http://localhost:8501
-
单独运行组件
- API 和 MCP 服务器:
bash python main.py - 仅仪表盘:
bash cd dashboard streamlit run app.py