Finance MCP Server

A Model Context Protocol (MCP) server that provides real-time stock price data using the Alpha Vantage API.

Features

• Get Current Price: Fetch real-time stock quotes.
• Caching: Redis-based caching to reduce API calls (5-second TTL).
• Dockerized: specific setup for easy deployment.

Prerequisites

• Docker
• Alpha Vantage API Key (Free)

Setup

1. Clone the repository

2. Configure Environment Copy .env.example to .env and add your API Key:

   cp .env.example .env

   Edit .env and set ALPHA_VANTAGE_API_KEY.

3. Run with Docker

   docker-compose up --build

Usage

Using with MCP Inspector

To test the server locally with the MCP Inspector:

# Install dependencies
pip install -r requirements.txt

# Start Redis (independent of Docker Compose if testing locally)
docker run -d -p 6379:6379 redis:alpine

# Run Inspector
npx @modelcontextprotocol/inspector python FinanceMCP.py