🚀 财务分析 MCP 服务器
这是一个功能强大的财务分析服务器，可提供股票数据检索和可视化功能，帮助用户更好地进行财务分析。
🚀 快速开始
本财务分析 MCP 服务器能让你轻松获取股票数据并进行可视化展示。以下是快速启动服务器的步骤：
- 启动服务器：
cd src
python main.py
- 服务器将在
http://localhost:8000上运行。 - 访问 API 文档：
http://localhost:8000/docs。
✨ 主要特性
- 从 yfinance 获取股票数据，为你提供丰富的股票信息。
- 集成 Alpha Vantage API，可获取额外的股票数据。
- 支持财务信息的网络搜索，满足你对各类财务信息的需求。
- 使用 Plotly 进行交互式可视化，让数据展示更加直观。
- 提供 RESTful API 端点，方便与其他系统集成。
📦 安装指南
在使用本服务器前，你需要完成以下安装步骤：
先决条件
- Python 3.8+
- Alpha Vantage API 密钥（用于获取额外数据）
安装步骤
- 克隆仓库：
git clone
cd fin-mcp
- 创建虚拟环境并激活：
python -m venv venv
source venv/bin/activate # 在 Windows 上：venv\Scripts\activate
- 安装依赖项：
pip install -r requirements.txt
- 在根目录创建一个
.env文件，并添加你的 Alpha Vantage API 密钥：
ALPHA_VANTAGE_API_KEY=your_api_key_here
💻 使用示例
基础用法
import requests
# 获取股票数据
response = requests.get("http://localhost:8000/api/v1/stock/AAPL")
data = response.json()
# 获取烛台图
response = requests.get("http://localhost:8000/api/v1/visualize/candlestick/AAPL")
chart_data = response.json()
📚 详细文档
API 端点
股票数据
GET /api/v1/stock/{symbol}- 从 yfinance 获取股票数据。GET /api/v1/alpha-vantage/{symbol}- 从 Alpha Vantage 获取股票数据。GET /api/v1/search/{query}- 搜索财务信息。
可视化
GET /api/v1/visualize/candlestick/{symbol}- 获取烛台图。GET /api/v1/visualize/volume/{symbol}- 获取成交量图。GET /api/v1/visualize/combined/{symbol}- 获取价格和成交量组合图。
📄 许可证
该项目使用 MIT License 许可证，详情请参阅 LICENSE 文件。