liwoo/mw-econ-analyst

An AI Economic Analyst MCP Server grounded on 5 years worth of Malawi Economic Data from Bridgepath Capital # Malawi Financial Intelligence — MCP Server MCP server + REST API exposing Malawi's financial market data as structured tools for AI assistants. Covers equities, fixed income, FX, commodities, tobacco, real estate, and macroeconomics. Data sourced from Bridgepath Capital PDF reports and external live feeds. Built with .NET 9, Dapper for data access, TimescaleDB for time-series storage, FastEndpoints for the REST API, .NET Aspire for orchestration, Docling for PDF parsing, and the official MCP C# SDK. --- ## Prerequisites - .NET 9 SDK - Docker and Docker Compose - Python 3.10+ (for the PDF scraper) --- ## Installation ```bash git clone github.com cd malawi-financial-mcp docker compose up -d # Run all migrations psql postgresql://postgres:malawi_agent@localhost:5432/malawi_financial \ -f Migrations/001_InitSchema.sql \ -f Migrations/002_AddMonthlyTables.sql \ -f Migrations/003_AddCommodityExpansion.sql \ -f Migrations/004_AddTobaccoTables.sql \ -f Migrations/005_AddRealEstateAndMinerals.sql \ -f Migrations/006_AddUniqueConstraints.sql dotnet restore && dotnet build ``` --- ## Running ```bash # All services via Aspire (recommended for local dev) dotnet run --project MalawiFinancialMcp.AppHost # Or run individually: # MCP server — stdio transport (Claude Desktop) dotnet run --project MalawiFinancialMcp -- --transport stdio # MCP server — HTTP transport (Claude.ai, ChatGPT, Copilot) dotnet run --project MalawiFinancialMcp -- --transport http --port 5000 # REST API server (dashboard, non-AI clients) dotnet run --project MalawiFinancialApi -- --port 5001 ``` The Aspire dashboard provides health checks, logs, and traces for all services at `localhost`. --- ## Ingesting Data ```bash # Scrape Bridgepath Capital PDFs cd scraper && pip install requests beautifulsoup4 && python scraper.py # Weekly — backfill all historical dotnet run --project MalawiFinancialMcp -- ingest --type weekly --directory ./da …