Finance_mcp-server
A Model Context Protocol (MCP) server that provides real-time financial data to Large Language Models through Yahoo Finance.
This project creates an MCP server that allows AI models like Claude to access real-time stock and financial data through the Yahoo Finance API. The server implements the Model Context Protocol standard, enabling seamless integration with various MCP clients including Claude Desktop, Cursor, Winds AI, and others.
🚀 Features
Real-time Stock Price Lookup: Get current prices for any publicly traded company
Historical Data Analysis: Retrieve stock performance over custom time periods
Company Information: Access detailed company profiles and financial metrics
Stock Comparison: Compare multiple stocks based on various metrics
Stock Search: Find relevant stocks by company name or keywords
Resource Access: Use structured URI schemes for financial data access
📋 Requirements
💻 Installation
Clone this repository:
git clone https://github.com/dino65-dev/Finance_mcp-server.gitCreate a virtual environment:
python -m venv venv On Windows: venv\Scripts\activate
Create a virtual environment (recommended) for faster creation:
Install dependencies:
pip install -r requirements.txt
🔧 Usage
Running the Server
Start the server by running:
The server will run as a stdin/stdout process that communicates via the MCP protocol.
Integrating with MCP Clients
Claude Desktop
Open Claude Desktop
Go to Settings
Add an MCP configuration with:
{ "mcpServers": { "yfinance": { "command": "python", "args": [ "/absolute/path/to/yfinance_mcp_server.py" ] } } }Save and restart Claude Desktop
Cursor
Open Cursor and access settings
Navigate to MCP section
Add a new global MCP server with the configuration:
{ "yfinance": { "command": "python", "args": [ "/absolute/path/to/yfinance_mcp_server.py" ] } }Start a new chat to use the financial tools
📊 Available Tools
The server provides the following tools:
get_stock_price
: Get current stock pricesExample: Get the current price of Apple stockget_historical_data
: Retrieve historical price dataExample: Get the stock history for TSLA over the past 3 monthsget_stock_metric
: Access specific financial metricsExample: What is Amazon's market capitalization?compare_stocks
: Compare multiple stocks by metricsExample: Compare the P/E ratios of Google, Microsoft, and Applesearch_stocks
: Find stocks by name or keywordExample: Find stocks related to artificial intelligence
🔍 Resource URIs
Access stock information directly through resource URIs:
finance://SYMBOL/info
- Get basic information about a stock
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgements
Yahoo Finance for providing financial data
yfinance for the Python API
Anthropic for the MCP specification
📞 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides real-time financial data from Yahoo Finance to Large Language Models through the Model Context Protocol, enabling AI models to access stock prices, historical data, and company information.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.Last updated -20MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables interaction with Yahoo Finance to retrieve stock pricing, company information, and historical financial data through natural language queries.Last updated -1016MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for interacting with Yahoo Finance, allowing users to retrieve stock prices, company information, and perform financial data comparisons.Last updated -11MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server providing comprehensive financial data from Yahoo Finance, allowing users to retrieve detailed stock information, financial statements, options data, and market news.Last updated -34MIT License