Finance_mcp_server

What is Finance_mcp-server?

Finance_mcp-server is a Model Context Protocol (MCP) server that provides real-time financial data to Large Language Models through Yahoo Finance. It enables AI models like Claude to access stock prices, historical data, company profiles, and other financial metrics, and integrates with MCP clients such as Claude Desktop, Cursor, and Winds AI.

How to use Finance_mcp-server?

Install Python 3.9+, clone the repository, create a virtual environment, and install dependencies with pip install -r requirements.txt. Start the server by running python yfinance_mcp_server.py. Then configure an MCP client (e.g., Claude Desktop or Cursor) with a JSON configuration pointing to the server script.

Key features of Finance_mcp-server

• Real-time stock price lookup for publicly traded companies.
• Historical data analysis over custom time periods.
• Detailed company profiles and financial metrics.
• Compare multiple stocks using various metrics.
• Search stocks by company name or keywords.

Use cases of Finance_mcp-server

• Ask an AI assistant for the current price of Apple stock.
• Retrieve the past three months of TSLA stock history.
• Get Amazon’s market capitalization through a natural language query.
• Compare P/E ratios of Google, Microsoft, and Apple.
• Find stocks related to artificial intelligence by keyword.

FAQ from Finance_mcp-server

What are the system requirements?

Python 3.9 or higher, plus the yfinance and mcp packages.

How do I install Finance_mcp-server?

Clone the repository, create a virtual environment (recommended), and run pip install -r requirements.txt.

How do I connect it to Claude Desktop?

Open Claude Desktop Settings, add an MCP configuration with the command python /absolute/path/to/yfinance_mcp_server.py, save, and restart.

What tools does the server provide?

Five tools: get_stock_price, get_historical_data, get_stock_metric, compare_stocks, and search_stocks.

Where does the financial data come from?

All data is sourced from Yahoo Finance via the yfinance library.