MCP Yfinance Server

This project is a stock price server based on the Yahoo Finance API, designed specifically for MCP (Multi - Agent Control Protocol), providing functions such as real - time stock data acquisition, watchlist management, and technical analysis.

Finance Developer tools #Stock Analysis #Real - Time Data #Technical Indicators #MCP Integration .Python

rating : 2.5 points

downloads : 65

update time : 2025-04-29

What is the MCP YFinance Stock Server?

The MCP YFinance Stock Server is a tool built on the Yahoo Finance API, designed to provide real - time stock data services for AI clients or developers. It allows users to easily obtain stock prices, analyze technical indicators, manage custom stock lists, and more.

How to use the MCP YFinance Stock Server?

Through simple installation and configuration, you can quickly start the server and use the various tools it provides to monitor and analyze the stock market.

Applicable Scenarios

This server is very suitable for professional investors who need real - time stock data, AI developers, and individual users who want to build personalized financial tools.

Main Features

Real - Time Stock Price QueryGet the current market price of the specified stock.

Technical AnalysisGenerate a comprehensive technical summary, including indicators such as RSI, MACD, and moving averages.

Volatility AnalysisCalculate historical volatility and ATR indicators.

Trend AnalysisDetect recent trend changes and divergence phenomena.

Visualization ChartsGenerate stock price charts and visual summaries.

Advantages and Limitations

Advantages

No need to pay high fees for third - party APIs.

Powerful technical analysis capabilities.

Support integration with multiple programming languages.

Real - time updated stock data.

Functions that are easy to expand and customize.

Limitations

Data may be delayed by a few minutes.

Limited to the data scope provided by Yahoo Finance.

Requires a certain technical background to fully utilize its potential.

How to Use

Install the Environment

Use the uv tool to initialize the project environment and activate the virtual environment.

Install Dependencies

Run the uv install . command to install all necessary dependencies.

Start the Server

Execute uv run source/yf_server.py to start the MCP YFinance server.

Usage Examples

Case 1: Compare Stock PricesCompare the stock prices of Apple and Tesla.

Case 2: Get Historical DataGet the historical stock price data of Tesla in the past month.

Case 3: Add to WatchlistAdd Apple, Tesla, and Reliance Industries to the watchlist.

Frequently Asked Questions

How to start using the MCP YFinance server?

Which programming languages does the server support?

Is the data updated in real - time?

Related Resources

GitHub Repository

View the complete code and documentation.

Detailed Blog

Learn more about the story behind the server development.

MCP Official Documentation

Understand how the MCP protocol works.

🚀 mcp-yfinance-server: Solve the Trouble of Stock Data Acquisition with Local API

In the field of quantitative trading, data is the core asset. However, paid APIs and data sources are not only expensive but also subject to strict rate limits. To help developers overcome these obstacles, we've developed an open-source local stock data analysis tool - mcp-yfinance-server.

🚀 Quick Start

mcp-yfinance-server is an open-source local stock data analysis tool designed to provide a free and efficient solution for quantitative trading and financial data analysis. It supports multi-platform use and is easy to integrate into various systems.

✨ Features

💡 Provide a completely free data acquisition solution.
🔧 Support multi-platform (Web, desktop) usage.
🛠️ Facilitate integration into quantitative trading systems or AI agents.
📈 Conduct real-time stock data analysis.
🚀 Support multiple markets (US, Europe, etc.).
🔍 Offer technical analysis indicators (RSI, MACD, MA, etc.).

📦 Installation

🏷️ Quick Installation

git clone https://github.com/Adity-star/mcp-yfinance-server.git
cd mcp-yfinance-server
npm install

📊 Results Display

Property	Details
✅ Stock Analysis	Obtain information such as price, OHLC data, earnings, and trading volume.
📈 Technical Analysis	Access indicators like RSI, MACD, MA, etc., and get a complete technical report.
📉 Volatility Report	Analyze stock risks and provide metrics such as ATR and volatility.
🔍 Trend Analysis	Detect price trend changes and deviations.
🧠 Data Visualization	More than 18 tools support AI agents or dashboards to visually display stock data.
📋 Technical Charts	Analyze and monitor stock technical indicators in real-time.
🖼️ Visual Insights	Generate charts and summaries using Claude Desktop.

💻 Usage Examples

1. Clone the Repository

git clone https://github.com/Adity-star/mcp-yfinance-server.git

2. Install Dependencies

cd mcp-yfinance-server
npm install

3. Start the Service

node index.js

🤝 Feedback and Contribution

🐛 Report Issues

If you encounter errors or have suggestions for improvement, please submit an issue in Issues. Please include:

🏷️ Steps to reproduce (if applicable).
🔍 Expected and actual results.
📷 Screenshots or error logs (if relevant).

📬 Submit PRs

If you have fixes or improvements, please go to Pull Requests to submit your PR. We'll review and merge it as soon as possible.

🔗 Share and Contact

🌟 Please star the repository.
🍴 Fork the repository and build your own financial tools.
📲 Mention me on X - I'll reply!

📄 License

This project is licensed under the MIT License. For details, please see LICENSE.

💡 Project Significance

Through mcp-yfinance-server, we aim to provide an efficient and free local solution for quantitative trading and financial data analysis. Whether you're an individual developer or a team, you can freely use and modify this tool.