StockMCP

StockMCP is an MCP (Model Context Protocol) server that allows AI assistants such as Claude Desktop and Cursor to retrieve real-time US stock market information through structured tools.

StockMCP provides stock prices, historical data, company information, market data, and financial news through MCP tools that can be used by Claude Desktop, Cursor, and other MCP-compatible AI clients.

Claude Desktop
        │
        │ MCP
        ▼
+----------------------+
|      StockMCP        |
|----------------------|
| stock_price()        |
| stock_history()      |
| stock_news()         |
| company_info()       |
| market_status()      |
| income_statement()   |
+----------------------+
        │
        ▼
 Yahoo Finance

Features

• Real-time stock prices
• Historical OHLCV data
• Company information
• Market capitalization
• Valuation metrics
• Financial news
• Market overview
• AI-ready MCP tools

Available Tools

Tool	Description
stock_price()	Latest stock price
stock_history()	Historical OHLCV data
company_info()	Company information
stock_news()	Latest financial news
market_status()	Market index information
income_statenemt()	Financial statement
balance_sheet()	Company balance sheet
cash_flow()	Company cash flow
financial_ratios()	Financial ratios
valuation_ratios()	Valuation ratios
profitability_analysis()	Profitability analysis
liquidity_analysis()	Liquidity analysis
leverage_analysis()	Leverage analysis
valuation_analysis()	Valuation analysis
financial_health_analysis()	Financial health analysis

Supported AI Clients

Client	Supported
Claude Desktop	✅
Cursor	✅
VS Code + MCP	Planned
Windsurf	Planned

Quick Start

Requirements

• Python 3.11+

Dependencies:

• MCP
• yfinance

---

Clone the Repository

git clone https://github.com/byronguo/StockMCP.git
cd StockMCP

Create Virtual Environment

python -m venv .venv
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Activate it:

Windows:

.venv\Scripts\activate

macOS/Linux:

source .venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Run StockMCP Server

python server.py

Claude Desktop Configuration

Add below configuration in claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\MCP_Claude"
      ]
    },
    "StockMCP": {
      "command": "C:\\Python314\\python.exe",
      "args": [
        "C:\\MCP_Claude\\StockMCP\\server.py"
      ]
    }
  }
  ...
}

Restart Claude Desktop.

Test

Cursor Configuration

Add below configuration in mcp.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\MCP_Claude"
      ]
    }    
  },
  "StockMCP": {
    "command": "python",
    "args": [
      "C:\\MCP_Claude\\StockMCP\\server.py"
    ]
  }
}

Roadmap

v0.1

• stock server

v0.2

• refactored architecture

• company

• market

• news

• Stock price

• Historical data

• Company information

• Market data

• Stock news

• Financial statements

• Financial analysis

Upcoming:

• Options chain
• Technical indicators
• AI stock analysis

Topics

mcp claude cursor stock finance ai python yfinance