Fin MCP

🚀 財務分析 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 文件。