Stock Price MCP Server

A FastMCP-based stock price query server providing real-time stock market data.

Features

Powered by yfinance for real-time stock data:

• get_stock_price(symbol: str) - Get real-time stock price and related information

  • Supports US stocks (AAPL, GOOGL, TSLA, MSFT, etc.)

  • Supports Taiwan stocks (2330.TW, 2317.TW, etc.)

  • Returns price, change, volume, market cap, and more

• get_stock_history(symbol: str, period: str) - Get historical prices

  • Period options: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max

  • Returns OHLCV (Open, High, Low, Close, Volume) data

• get_stock_info(symbol: str) - Get detailed stock information

  • Company name, sector, country

  • Employee count, market cap, P/E ratio

  • 52-week high/low, and more

• greet(name: str) - Greeting tool

Related MCP server: Finance MCP Server

Quick Deploy to FastMCP Cloud

Step 1: Fork or Clone this Repository

git clone https://github.com/YOUR_USERNAME/stock-price-mcp-server.git
cd stock-price-mcp-server

Step 2: Push to Your GitHub

git remote set-url origin https://github.com/YOUR_USERNAME/stock-price-mcp-server.git
git push -u origin main

Step 3: Deploy to FastMCP Cloud

1. Go to FastMCP Cloud

2. Sign in with your GitHub account

3. Click "Create New Project"

4. Fill in project information:

   • Name: stock-price-server (or your preferred name)

   • GitHub Repository: Select your repository

   • Entry Point: server.py:mcp

   • Authentication: Choose Public or Organization only

5. Click "Deploy"

Step 4: Use Your Server

After deployment, your server will be available at:

https://your-project-name.fastmcp.app/mcp

You can connect this server in Claude Desktop, Cursor, or other MCP clients.

Local Development

Requirements

• Python 3.10 or higher

• uv (recommended) or pip

• FastMCP CLI

Install Dependencies

Using uv:

uv pip install -r requirements.txt

Run the Server Locally

Start the FastMCP development server:

fastmcp dev server.py:mcp

The server will be available at http://localhost:8000

Note: Don't use uv run server.py - FastMCP servers must be run through the fastmcp CLI tool.

Verify Server Configuration

Inspect the server without running it:

fastmcp inspect server.py:mcp

Test the Server

After starting the server, you can test it using the test client (in a separate terminal):

uv run main.py

Supported Stock Symbols

US Stocks

• AAPL - Apple Inc.

• GOOGL - Alphabet Inc.

• TSLA - Tesla Inc.

• MSFT - Microsoft Corporation

• NVDA - NVIDIA Corporation

• META - Meta Platforms Inc.

Taiwan Stocks

• 2330.TW - Taiwan Semiconductor

• 2317.TW - Hon Hai Precision

• 2454.TW - MediaTek

• 2412.TW - Chunghwa Telecom

Other Markets

• 9988.HK - Alibaba (Hong Kong)

• 600519.SS - Kweichow Moutai (Shanghai)

Usage Examples

Using in Claude Desktop

1. Open Claude Desktop settings

2. Add MCP server:

{
  "mcpServers": {
    "stock-price": {
      "url": "https://your-project-name.fastmcp.app/mcp"
    }
  }
}

3. Restart Claude Desktop

4. Now you can ask: "What's the stock price of AAPL?" or "Show me TSMC's price trend for the last month"

Using FastMCP Client

import asyncio
from fastmcp import Client

async def query_stock():
    client = Client("https://your-project-name.fastmcp.app/mcp")
    async with client:
        # Query real-time stock price
        result = await client.call_tool("get_stock_price", {"symbol": "AAPL"})
        print(result.data)

        # Query historical prices
        history = await client.call_tool("get_stock_history", {
            "symbol": "TSLA",
            "period": "1mo"
        })
        print(history.data)

asyncio.run(query_stock())

Technical Details

• Data Source: Yahoo Finance (via yfinance package)

• Update Frequency: Real-time (15-minute delay per Yahoo Finance API limits)

• Supported Markets: Major global stock markets (US, Taiwan, Hong Kong, China, etc.)

• Deployment Platform: FastMCP Cloud

• Auto Deployment: Automatically redeploys on push to main branch

• PR Preview: Each PR gets a unique testing URL

File Structure

stock-price-mcp-server/
├── server.py           # FastMCP server implementation
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project configuration
├── .gitignore         # Git ignore rules
└── README.md          # Documentation

License

MIT License

Contributing

Issues and Pull Requests are welcome!

Support

For questions:

1. Check FastMCP Official Documentation

2. Submit a GitHub Issue

3. Visit FastMCP Cloud for help