mcpField
F
Financial Analysis MCP Server

Financial Analysis MCP Server

Local
github.com/cristianleooFinance0Updated 82w ago
Repository

About Financial Analysis MCP Server

Financial Analysis MCP Server provides stock data, financial web search, and Plotly visualizations through a server with REST endpoints. It is intended for users and applications that need to retrieve or chart financial information.

Key features

  1. 01Retrieves stock data from yfinance
  2. 02Connects to Alpha Vantage
  3. 03Searches the web for financial information
  4. 04Creates Plotly price and volume charts
  5. 05Provides REST API endpoints

Use cases

  1. 01Retrieving stock data by ticker
  2. 02Searching for financial information
  3. 03Viewing candlestick or volume charts

MCP support

The project is presented as an MCP server for financial analysis, exposing stock retrieval, search, and visualization capabilities to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Financial Analysis MCP Server

A powerful server for financial analysis capabilities, providing stock data retrieval and visualization features.

Features

  • Stock data retrieval from yfinance
  • Alpha Vantage API integration
  • Web search for financial information
  • Interactive visualization with Plotly
  • RESTful API endpoints

Prerequisites

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

Installation

  1. Clone the repository:
git clone <repository-url>
cd fin-mcp
  1. Create a virtual environment and activate it:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Create a .env file in the root directory and add your Alpha Vantage API key:
ALPHA_VANTAGE_API_KEY=your_api_key_here

Usage

  1. Start the server:
cd src
python main.py

  1. The server will start at http://localhost:8000

  2. Access the API documentation at http://localhost:8000/docs

API Endpoints

Stock Data
  • GET /api/v1/stock/{symbol} - Get stock data from yfinance
  • GET /api/v1/alpha-vantage/{symbol} - Get stock data from Alpha Vantage
  • GET /api/v1/search/{query} - Search for financial information
Visualization
  • GET /api/v1/visualize/candlestick/{symbol} - Get candlestick chart
  • GET /api/v1/visualize/volume/{symbol} - Get volume chart
  • GET /api/v1/visualize/combined/{symbol} - Get combined price and volume chart

Example 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()

License

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.