💹 MCP YFinance Stock Server

This project sets up a stock Price server powered by the Yahoo Finance (YFinance) API and built for seamless integration with MCP (Model Control Protocol).

It allows AI agents or clients to:

• Retrieve real-time stock data
• Manage a watchlist
• Perform full stock analysis
• Run full technical indicators
• And much more

🪙 Start Simple: Build a Crypto Price Tracker First

Before diving into the full-blown stock server, I recommend starting with this simple crypto tracker built with Python + MCP 👇

🔗 GitHub Repo: https://github.com/Adity-star/mcp-crypto-server

You'll learn how to:

• Use MCP to expose crypto tools like get_price("BTC")
• Build an API with FastAPI
• Fetch real-time prices using the Alpaca API

🔗 Related Projects

Explore more of my work:

• GenAI-Learnings: A deep dive into Generative AI concepts, tools, and projects.
• LangChain-Mastery: Everything you need to master LangChain for building powerful LLM applications.
• Complete Data Science: A deep dive into Data Science AI concepts, tools, and projects and all the material for learning and interview preparation.
• Reinforcement-Learning: Hands-on experiments and theory in Reinforcement Learning.
• CompleteRAG: End-to-end implementation of Retrieval-Augmented Generation (RAG) systems.

📈 Then Level Up: Build the yFinance Stock Server

Once you're familiar with the flow, move on to this more advanced stock tracker 💹

🔗 GitHub Repo: https://github.com/Adity-star/mcp-yfinance-server

📝 Detailed Blog: 👉 How I Built My Own Stock Server with Python, yFinance, and a Touch of Nerdy Ambition

Includes:

• Watchlists
• Real-time(ish) price updates
• Technical summaries
• A full-featured dashboard
• Trend + momentum indicators
• Watchlist management

📦 Step 1: Set Up the Environment (with uv)

We use uv — a modern, ultra-fast Python package manager — to manage our project environment.

🛠️ Installation & Setup

Run the following commands in your terminal:

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh 

# Create and navigate to your project directory
mkdir mcp-yfinance-server
cd mcp-yfinance-server

# Initialize a new project
uv init

# Create and activate the virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

📥 Install the project

Once your pyproject.toml is set up with dependencies, run:

#  Run 
uv pip install -e .

🚀 Step 2: Running the MCP Server

Once your environment is ready, start the stock server:

uv run main.py

🧪 Want a quick test first? Try checking the tools first:

python run test_server_fun.py

📄 Curious how the full server works?

Explore the source code here:

🔗 [yf_server.py › GitHub](https://github.com/Adity-star/mcp-yfinance-server/blob/m

... View full README on GitHub