Trading-MCP-Server

Trading-MCP-Server

An intelligent trading assistant that integrates with the Claude AI MCP (Model Context Protocol) platform. This tool fetches live stock prices using Yahoo Finance and enables seamless command-based interaction with the market via Claude's agent interface.

🚀 Features

• 🔄 Fetches real-time (or near real-time) stock prices using Yahoo Finance
• 🤖 Connects to Claude MCP as a server with custom trading commands
• 🛠 Built using Python with support for virtual environments and uv for dependency management
• ⚙️ Supports modular expansion to include trading signals, historical analysis, and more

🧠 Architecture

• Claude AI MCP Integration: Uses mcp[cli] to expose a server interface to Claude.
• Yahoo Finance API: For retrieving stock data (via yfinance).
• Virtual Environment: Managed using uv for fast and deterministic builds.

📦 Setup

# Install uv if not already installed
brew install uv

# Navigate to the project directory
cd MCPtrading

# Install dependencies
uv pip install -r requirements.txt

# (Optional) Add packages
uv add yfinance

🏃‍♀️ Running the Server

Make sure to use the correct Python environment:

uv run --python .venv/bin/python --with "mcp[cli]" mcp run trader_tools.py

Or update your Claude config:

{
  "mcpServers": {
    "Trading": {
      "command": "/Users/yourname/.local/bin/uv",
      "args": [
        "run",
        "--python",
        "/full/path/to/.venv/bin/python",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "trader_tools.py"
      ]
    }
  }
}

🧪 Example Usage

Ask Claude:

"What's the latest price of AAPL?"

Claude will call the MCP server and respond with the current stock price.