🏦 Financial Intelligence MCP Server

A production-grade Model Context Protocol (MCP) server that exposes financial ML tools to any MCP-compatible AI client (Claude Desktop, Cursor, etc.).

Built entirely with free, open-source tools — no paid APIs required.

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│              MCP-Compatible Client                              │
│         (Claude Desktop / Cursor / Any LLM)                     │
└─────────────────────┬───────────────────────────────────────────┘
                      │ MCP Protocol (stdio)
                      ▼
┌─────────────────────────────────────────────────────────────────┐
│                  financial-mcp-server                           │
│                     server.py                                   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    Tool Router                           │   │
│  └──┬────────────┬────────────┬───────────┬─────────────────┘   │
│     │            │            │           │           │          │
│     ▼            ▼            ▼           ▼           ▼          │
│ ┌───────┐  ┌─────────┐  ┌────────┐  ┌────────┐  ┌─────────┐   │
│ │  RAG  │  │Anomaly  │  │Contract│  │Vendor  │  │ Drift   │   │
│ │Search │  │Detect.  │  │Summary │  │ Graph  │  │Monitor  │   │
│ └───┬───┘  └────┬────┘  └───┬────┘  └───┬────┘  └────┬────┘   │
└─────┼───────────┼───────────┼───────────┼────────────┼─────────┘
      │           │           │           │            │
      ▼           ▼           ▼           ▼            ▼
   FAISS +    sklearn       Ollama      Neo4j /    Evidently
 sentence-  IsolationF.   (local LLM)  NetworkX    AI / KS
transformers  (free)      (free)       (free)      Test (free)

🛠️ Tools

| Tool | Description | Free Stack Used | |------|-------------|-----------------| | search_financial_docs | RAG over financial PDFs/docs | FAISS + sentence-transformers + Ollama | | analyze_expense_pattern | Anomaly detection on transactions | scikit-learn IsolationForest | | summarize_contract | Extract key clauses from contracts | Ollama Mistral + regex fallback | | get_vendor_relationships | Query vendor knowledge graph | Neo4j Community + NetworkX fallback | | monitor_model_drift | Detect data/feature drift in models | Evidently AI + scipy KS test fallback |

💸 100% Free Stack

| Component | Tool | Cost | |-----------|------|------| | LLM | Ollama + Mistral 7B (local) | FREE | | Embeddings | sentence-transformers all-MiniLM-L6-v2 | FREE | | Vector Store | FAISS (Meta) | FREE | | Anomaly Detection | scikit-learn IsolationForest | FREE | | Graph Database | Neo4j Community Edition | FREE | | Drift Monitoring | Evidently AI open-source | FREE | | MCP Framework | Anthropic MCP Python SDK | FREE |

🚀 Quick Start

1. Clone & Install

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

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Start Ollama (free local LLM)

# Install Ollama from https://ollama.com (free)
ollama serve
ollama pull mistral   # ~4GB download, one time

3. Add Your Documents (optional)

# Drop any .txt, .md, or .pdf files into:
data/sample_docs/

# Index them (auto-happens on first run, or manually):
python -c "from tools.rag_search import _load_or_build_index; _load_or_build_index()"

4. Run the MCP Server

python server.py

5. Connect to Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "financial-intelligence": {
      "command": "python",
      "args": ["/absolute/path/to/financial-mcp-server/server.py"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/financial-mcp-server"
      }
    }
  }
}

Restart Claude Desktop. You'll see the 🔧 tools icon appear.

🐳 Docker Setup (with Neo4j)

# Start Neo4j Community Edition + MCP server
docker-compose up -d

# Check logs
docker-compose logs -f mcp-server

Neo4j browser available at: http://localhost:7474

🧪 Run Tests

pip install pytest
pytest tests/ -v

💬 Example Claude Desktop Conversations

Once connected, ask Claude:

"Search my financial documents for information about payment terms with TechVendor Solutions"

"Analyze these transactions for anomalies: [paste JSON list]"

"Summarize this contract and flag any risky clauses: [paste contract text]"

"What vendors are related to TechVendor Solutions and what's their risk level?"

"Check if the fraud_detector model has drifted and whether it needs retraining"

📁 Project Structure

financial-mcp-server/
├── server.py                  # MCP server — tool registry & routing
├── tools/
│   ├── rag_search.py          # search_financial_docs
│   ├── anomaly_detection.py   # analyze_expense_pattern
│   ├── contract_summary.py    # summarize_contract
│   ├── vendor_graph.py        # get_vendor_relationships
│   └── drift_monitor.py       # monitor_model_drift
├── data/
│   └── sample_docs/           # Drop your financial docs here
├── tests/
│   └── test_tools.py          # pytest test suite
├── .github/workflows/
│   └── ci.yml                 # GitHub Actions CI
├── Dockerfile
├── docker-compose.yml         # Includes Neo4j Community Edition
├── requirements.txt
└── claude_desktop_config.json # Copy into Claude Desktop config

🔗 Related Projects

Financial-RAG-Pipeline — Standalone RAG system (precursor to this project)

📄 License

MIT License — free to use, modify, and distribute.

MCP Servers