🚀 财务分析 MCP 服务器

这是一个功能强大的财务分析服务器，可提供股票数据检索和可视化功能，帮助用户更好地进行财务分析。

🚀 快速开始

本财务分析 MCP 服务器能让你轻松获取股票数据并进行可视化展示。以下是快速启动服务器的步骤：

1. 启动服务器：

cd src
python main.py

2. 服务器将在 http://localhost:8000 上运行。
3. 访问 API 文档：http://localhost:8000/docs。

✨ 主要特性

• 从 yfinance 获取股票数据，为你提供丰富的股票信息。
• 集成 Alpha Vantage API，可获取额外的股票数据。
• 支持财务信息的网络搜索，满足你对各类财务信息的需求。
• 使用 Plotly 进行交互式可视化，让数据展示更加直观。
• 提供 RESTful API 端点，方便与其他系统集成。

📦 安装指南

在使用本服务器前，你需要完成以下安装步骤：

先决条件

• Python 3.8+
• Alpha Vantage API 密钥（用于获取额外数据）

安装步骤

1. 克隆仓库：

git clone <repository-url>
cd fin-mcp

2. 创建虚拟环境并激活：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 在根目录创建一个 .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 文件。