# 📈 Stock-MCP
### AI-Powered Stock Market MCP Server for GitHub Copilot

> A production-ready **Model Context Protocol (MCP) Server** built with **Python** and **FastMCP** that enables **GitHub Copilot Agent Mode** to access live stock market data, company information, technical analysis, news, and portfolio analytics through intelligent AI tool calling.

---

## 🚀 Overview

Stock-MCP transforms GitHub Copilot into an intelligent financial assistant by exposing stock market capabilities as MCP tools.

Instead of relying on static knowledge, Copilot can invoke this server to fetch live financial information and perform real-time analysis.

Example:

> **User:** *What is the current stock price of Apple?*

↓

GitHub Copilot

↓

MCP Server

↓

Yahoo Finance

↓

Live Price Returned

↓

Copilot explains the result.

---

# ✨ Features

- 📊 Live Stock Price Lookup
- 🏢 Company Information
- 📰 Latest Financial News
- 📈 Technical Analysis
- 💼 Portfolio Valuation
- 📉 Portfolio Performance Analysis
- ⚡ FastMCP-based Tool Registration
- 🤖 GitHub Copilot Agent Mode Integration
- 🐍 Pure Python Implementation
- 🔧 Easily Extendable Architecture

---

# 🏗 Architecture

```text
                    User
                      │
                      ▼
            GitHub Copilot Agent
                      │
             Model Context Protocol
                      │
                      ▼
              Stock-MCP Server
                      │
      ┌───────────────┼────────────────┐
      │               │                │
      ▼               ▼                ▼
 Stock Tool      Company Tool      News Tool
      │               │                │
      └───────────────┼────────────────┘
                      │
               Yahoo Finance API
```

---

# 📂 Project Structure

```text
Stock-MCP/

├── server.py
├── mcp_app.py
├── mcp.json
├── requirements.txt
├── README.md
│
├── tools/
│   ├── ping.py
│   ├── stock.py
│   ├── company.py
│   ├── news.py
│   ├── technical.py
│   ├── portfolio.py
│   └── prediction.py
│
├── services/
├── utils/
├── models/
├── config/
└── tests/
```

---

# 🛠 Tech Stack

| Technology | Purpose |
|------------|---------|
| Python 3.12+ | Backend |
| FastMCP | MCP Framework |
| MCP SDK | Protocol Support |
| yfinance | Stock Data |
| Pandas | Data Processing |
| NumPy | Numerical Computing |
| TA | Technical Indicators |
| Pydantic | Validation |
| GitHub Copilot | MCP Client |

---

# 📦 Installation

Clone the repository

```bash
git clone https://github.com/Madhan-2096/Stock-MCP.git

cd Stock-MCP
```

Create a virtual environment

```bash
python -m venv .venv
```

Activate it

### Windows

```bash
.venv\Scripts\activate
```

### Linux / macOS

```bash
source .venv/bin/activate
```

Install dependencies

```bash
pip install -r requirements.txt
```

---

# ▶ Running the MCP Server

```bash
python server.py
```

Expected Output

```text
Starting MCP Server...

Transport: stdio

Waiting for requests...
```

---

# 🔗 Connecting with GitHub Copilot

Create an `mcp.json` configuration.

Example:

```json
{
  "servers": {
    "stock-market-assistant": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}
```

Reload GitHub Copilot Agent Mode.

Your tools will automatically become available.

---

# 🧰 Available MCP Tools

| Tool | Description |
|------|-------------|
| ping | Health check |
| get_stock_price | Get latest stock price |
| get_company_info | Company fundamentals |
| get_stock_news | Latest market news |
| technical_analysis | RSI, SMA, EMA, MACD |
| calculate_portfolio_value | Portfolio valuation |
| get_portfolio_performance | Portfolio return analysis |

---

# 💬 Example Prompts

### Get Stock Price

```
What is the current price of AAPL?
```

---

### Company Information

```
Tell me about Microsoft.
```

---

### Technical Analysis

```
Perform technical analysis for TSLA.
```

---

### News

```
Show today's news about NVIDIA.
```

---

### Portfolio

```
Calculate my portfolio.

AAPL - 10

MSFT - 5

GOOGL - 8
```

---

# 📊 Current Capabilities

✅ Live Stock Prices

✅ Company Information

✅ Technical Indicators

✅ Financial News

✅ Portfolio Valuation

✅ Portfolio Performance

✅ GitHub Copilot Integration

---

# 🚧 Roadmap

- [ ] Real-Time WebSocket Stock Streaming
- [ ] AI Investment Recommendations
- [ ] Sentiment Analysis
- [ ] Candlestick Pattern Detection
- [ ] Portfolio Optimization
- [ ] Stock Comparison Tool
- [ ] PDF Report Generator
- [ ] Alpha Vantage Integration
- [ ] Finnhub Integration
- [ ] Docker Support
- [ ] GitHub Actions CI/CD

---

# 🤝 Contributing

Contributions are welcome.

1. Fork the repository

2. Create a new feature branch

```bash
git checkout -b feature/new-feature
```

3. Commit your changes

```bash
git commit -m "Added new feature"
```

4. Push

```bash
git push origin feature/new-feature
```

5. Open a Pull Request

---

# 📜 License

This project is licensed under the MIT License.

---

# 👨‍💻 Author

**Madhan J R**

B.Tech Artificial Intelligence & Data Science

Meenakshi Sundararajan Engineering College

GitHub: https://github.com/Madhan-2096

---

## ⭐ Support

If you found this project useful,

please consider giving it a ⭐ on GitHub.

It helps others discover the project and motivates future development.

---