Architecture

# Hybrid server supporting both protocols
app = FastAPI(title="Financial MCP Server")
mcp = MCPServer("financial-data")

# Single server, dual protocols
if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=PORT)

# Centralized tool registration
@mcp.tool("get_stock_quote")
async def mcp_get_stock_quote(symbol: str):
    return await get_stock_quote(symbol)

@app.get("/api/v1/stock/{symbol}")
async def rest_get_stock_quote(symbol: str):
    return await get_stock_quote(symbol)

# Native Python library integration
async def get_stock_quote(symbol: str) -> Dict[str, Any]:
    def _fetch_quote():
        ticker = yf.Ticker(symbol)
        return ticker.info
    
    return handle_yfinance_request(_fetch_quote)

# Professional API integration
async def fmp_get_stock_quote(symbol: str) -> Dict[str, Any]:
    endpoint = f"quote/{symbol}"
    data = await fmp_request(endpoint)
    return format_response(data)

# Shared utilities and helpers
async def fmp_request(endpoint: str, params: dict = None) -> dict:
    # Common request handling
    # Error processing
    # Response validation

# Common interface for all data sources
class DataSource:
    async def get_quote(self, symbol: str) -> Dict[str, Any]
    async def get_company_info(self, symbol: str) -> Dict[str, Any]
    async def get_historical_data(self, symbol: str) -> Dict[str, Any]

# Strategy selection based on requirements
def select_data_source(requirement: str) -> DataSource:
    if requirement == "free":
        return YFinanceAdapter()
    elif requirement == "professional":
        return FMPAdapter()
    elif requirement == "hybrid":
        return HybridAdapter()  # Try YFinance, fallback to FMP

@rate_limit_protection
@error_handling
@response_formatting
async def get_stock_quote(symbol: str):
    # Core business logic
    pass

yfi-deployment/
├── main.py                 # Server entry point
├── api/
│   ├── __init__.py
│   └── rest_routes.py      # REST endpoint definitions
├── tools/
│   ├── __init__.py
│   ├── yfinance_tools.py   # YFinance integration (6 tools)
│   ├── fmp_tools.py        # FMP integration (26 tools)
│   └── fmp_utils.py        # Shared FMP utilities
├── requirements.txt        # Dependencies
├── Procfile               # Deployment configuration
└── docs/                  # Documentation (separate folder)

# Non-blocking I/O for concurrent requests
async def handle_multiple_requests():
    tasks = [
        get_stock_quote("AAPL"),
        get_stock_quote("MSFT"),
        get_stock_quote("GOOGL")
    ]
    results = await asyncio.gather(*tasks)
    return results

# Reuse HTTP connections
session = aiohttp.ClientSession(
    connector=aiohttp.TCPConnector(
        limit=100,
        limit_per_host=30
    )
)

# Cache frequently requested data
@lru_cache(maxsize=1000)
def get_cached_quote(symbol: str, timestamp: int):
    # Cache for 1 minute intervals
    return fetch_quote(symbol)

# Secure environment variable handling
FMP_API_KEY = os.getenv("FMP_API_KEY", "demo")
if FMP_API_KEY == "demo":
    logger.warning("Using demo API key - limited functionality")

# Strict parameter validation
def validate_symbol(symbol: str) -> str:
    if not symbol or len(symbol) > 10:
        raise ValueError("Invalid symbol")
    return symbol.upper().strip()

# Protect against abuse
@rate_limit(requests_per_minute=60)
async def protected_endpoint():
    pass

Local Machine
├── Python 3.11+
├── Virtual Environment
├── Environment Variables
└── Direct API Access

Railway Platform
├── Automatic Deployment
├── Environment Management
├── Load Balancing
├── SSL Termination
└── Monitoring & Logs

Docker Container
├── Python Runtime
├── Application Code
├── Dependencies
├── Environment Config
└── Health Checks

import logging

# Structured logging
logger = logging.getLogger(__name__)
logger.info("Stock quote requested", extra={
    "symbol": symbol,
    "source": "FMP",
    "response_time": response_time
})

@app.get("/api/v1/health")
async def health_check():
    return {
        "status": "healthy",
        "tools_available": 32,
        "data_sources": ["YFinance", "FMP"],
        "timestamp": datetime.now().isoformat()
    }