Financial MCP Server

# Financial MCP Server A Model Context Protocol (MCP) server for financial analysis, designed to deploy easily on a VPS with Cloudflare. ## 🚀 deployment Guide ### 1. Configuration 1. **Copy Environment File**: ```bash cp .env.example .env ``` 2. **Edit `.env`**: ```env # Your Domain (e.g. mcp.your-domain.com) DOMAIN=mcp.example.com # Cloudflare-Friendly Port (8080 is supported by Cloudflare Proxied mode) HOST_HTTP_PORT=8080 # Financial Data Source ALPHA_VANTAGE_API_KEY=your_key_here ``` ### 2. Start Service Run the stack (Nginx + Node App): ```bash docker-compose up -d --build ``` *Port 80 is used internally by the container, but mapped to 8080 on your host to avoid conflicts.* ### 3. Cloudflare Setup (Crucial) Since we are not managing SSL certificates locally (no Certbot), we rely on Cloudflare. 1. **DNS**: Create an `A Record` for your subdomain pointing to your VPS IP. Enable **Proxy (Orange Cloud)**. 2. **Origin Rules** (in Cloudflare Dashboard > Rules > Origin Rules): * **Rule**: `Hostname` equals `your-domain.com` * **Action**: Rewrite destination port to `8080`. *This allows you to access `https://mcp.your-domain.com` (Standard HTTPS) while your server listens safely on port 8080.* ## 🛠️ Local Development To run locally without Docker: ```bash npm install npm run build node dist/index.js # Stdio mode (for Claude Desktop) node dist/index.js serve # HTTP mode (for local testing) ```