AI导哈

股票市场分析工具

一款利用AlphaVantage API提供实时股票数据和技术分析的强大工具，集成了Model Context Protocol（MCP）使AI助手能够访问股票市场数据和分析。

  • by ai-agents-strategy
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ai-agents-strategy/mcp-stock-market-analysis

使用说明

MCP股票市场分析

一个强大的股票市场分析应用程序，利用AlphaVantage API提供实时股票数据和技术分析。该应用程序与模型上下文协议（MCP）集成，使AI助手能够访问股票市场数据和分析。

这个项目是基于这篇优秀的文章 分步指南：使用Python SDK、AlphaVantage和Claude AI构建MCP服务器 由Syed Hasan编写，并按照最新的MCP Python SDK最佳实践进行了改进。

特性

  • 实时股票报价：获取最新的股票价格和交易信息
  • 技术分析：计算并可视化RSI和移动平均线等关键指标
  • MCP集成：通过模型上下文协议与人工智能助手无缝集成
  • REST API：用于编程访问股票数据的FastAPI端点
  • 交互式仪表板：基于Streamlit的可视化仪表板

入门指南

先决条件

安装

  1. 克隆存储库

    git clone https://github.com/yourusername/mcp-stock-market-analysis.git
cd mcp-stock-market-analysis

  2. 创建并激活虚拟环境

    对于Windows：

    python -m venv venv
venv\Scripts\activate

    对于macOS/Linux：

    python -m venv venv
source venv/bin/activate

  3. 安装依赖项

    使用pip：

    pip install -e .

    或者使用紫外线（更快）：

    pip install uv
uv install

  4. 设置环境变量

    创建一个 .env 使用AlphaVantage API密钥在项目根目录中创建文件：

    ALPHA_VANTAGE_API_KEY=your_api_key_here

    您可以通过在注册获得免费的API密钥 AlphaVantage.

用法

运行完整的应用程序

运行整个应用程序（API服务器、MCP服务器和仪表板）的最简单方法是：

python server.py

这将开始：

  • FastAPI服务器已打开http://localhost:8000
  • MCP服务器已打开http://localhost:8080
  • 仪表板上的流光灯http://localhost:8501

单独运行组件

API和MCP服务器

python main.py

仅仪表板

cd dashboard
streamlit run app.py

api参考

REST API端点

端点 方法 描述 示例
/quote/{symbol} 获取 获取最新股票报价 /quote/AAPL
/analyze/{symbol} GET 使用指标获取详细的股票分析 /analyze/MSFT
/historical/{symbol} GET 使用技术指标获取历史数据 /historical/GOOGL

MCP工具

工具 说明 参数
get_stock_quote 获取最新股票报价 symbol：股票代码（例如AAPL）
analyze_stock 通过技术指标获得详细的库存分析 symbol：股票代码（例如AAPL）

MCP资源

资源 描述 示例URI
股票报价 获取格式化的股票报价信息 stock://AAPL/quote
库存分析 获取格式化的库存分析信息 stock://AAPL/analysis

例子

获取股票报价

curl http://localhost:8000/quote/AAPL

答复：

{
  "symbol": "AAPL",
  "price": 221.53,
  "change": -2.21,
  "change_percent": "-0.9889%",
  "volume": 58932401,
  "latest_trading_day": "2025-03-26"
}

与Claude或其他AI助手一起使用

MCP服务器运行后，您可以将其连接到Claude Desktop或其他兼容MCP的AI助手。然后，AI可以使用以下命令：

Get me the latest stock quote for Apple.
Analyze the recent performance of Microsoft stock.

故障排除

  • API关键问题：确保您的AlphaVantage API密钥在 .env 文件
  • 端口冲突：如果您收到“地址已在使用中”错误，请确保没有其他应用程序正在使用端口8000、8080或8501
  • 速率限制：AlphaVantage的免费版有使用限制。如果你遇到错误，你可能会超过这些限制

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP