Fin MCP

🚀 Financial Analysis MCP Server

A powerful financial analysis server that offers stock data retrieval and visualization capabilities.

🚀 Quick Start

The Financial Analysis MCP Server is a robust tool designed for retrieving and visualizing stock data. It integrates multiple data sources and provides a RESTful API for easy access.

✨ Features

• Retrieve stock data from yfinance.
• Integrate with the Alpha Vantage API.
• Conduct web searches for financial information.
• Provide interactive visualization using Plotly.
• Offer RESTful API endpoints.

📦 Installation

Prerequisites

• Python 3.8+
• Alpha Vantage API key (for additional data)

Steps

1. Clone the repository:

git clone <repository-url>
cd fin-mcp

2. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the dependencies:

pip install -r requirements.txt

4. Create a .env file in the root directory and add your Alpha Vantage API key:

ALPHA_VANTAGE_API_KEY=your_api_key_here

💻 Usage Examples

Basic Usage

import requests

# Get stock data
response = requests.get("http://localhost:8000/api/v1/stock/AAPL")
data = response.json()

# Get candlestick chart
response = requests.get("http://localhost:8000/api/v1/visualize/candlestick/AAPL")
chart_data = response.json()

Advanced Usage

You can use the API endpoints to perform more complex financial analysis and visualization tasks. For example, you can combine different types of data and charts to gain a comprehensive understanding of the stock market.

📚 Documentation

API Endpoints

Stock Data

• GET /api/v1/stock/{symbol} - Retrieve stock data from yfinance.
• GET /api/v1/alpha-vantage/{symbol} - Retrieve stock data from Alpha Vantage.
• GET /api/v1/search/{query} - Search for financial information.

Visualization

• GET /api/v1/visualize/candlestick/{symbol} - Get a candlestick chart.
• GET /api/v1/visualize/volume/{symbol} - Get a volume chart.
• GET /api/v1/visualize/combined/{symbol} - Get a combined price and volume chart.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.