Jalex

Serveur MCP (Model Context Protocol) Python pour exposer les données financières de Jalex Consulting (devis, factures, contrats) à des LLMs (Claude, Copilot, etc.) de manière sécurisée et déterministe.

Prérequis

• Python 3.12+
• pip

Installation

python -m venv .venv
.venv\Scripts\activate        # Windows
pip install -e ".[dev]"

Indexation des PDFs

Déposer les PDFs dans data/pdfs/ puis lancer :

python scripts/ingest.py --pdf-dir data/pdfs/

Démarrage du serveur MCP

python -m jalex_mcp.server

Ou via le point d'entrée installé :

jalex-mcp

Configuration client MCP (Claude Desktop)

Ajouter dans claude_desktop_config.json :

{
  "mcpServers": {
    "jalex": {
      "command": "python",
      "args": ["-m", "jalex_mcp.server"],
      "cwd": "D:/DEV/jalex-server-mcp"
    }
  }
}

Structure

src/jalex_mcp/
├── server.py       ← point d'entrée FastMCP
├── models.py       ← Pydantic models (Document, Facture, Devis)
├── storage.py      ← SQLite CRUD + queries métier
├── extractor.py    ← extraction PDF (pdfplumber)
├── resources.py    ← MCP Resources (jalex://...)
├── tools.py        ← MCP Tools (get_revenue_by_client, ...)
└── prompts.py      ← MCP Prompts / guardrails
data/
├── pdfs/           ← PDFs sources (non versionnés)
└── index.db        ← base SQLite générée
scripts/
└── ingest.py       ← CLI d'indexation

Tests

pytest tests/