Financial-MCP-Server- Assistant IA & Serveur MCP

Description du Projet

Ce projet a été réalisé dans le cadre d'un stage de 2ème année de licence. Il s'agit d'une application IA complète intégrant un serveur MCP (Model Context Protocol) en Python. Ce projet implémente un serveur FastMCP pour l'extraction, le calcul et l'analyse de données financières d'entreprises à partir de fichiers XML (bilans standards et bilans détaillés étendus). Il inclut un client frontend interactif développé avec Streamlit, connecté à un modèle de langage local via Ollama pour garantir la sécurité et la confidentialité totale des données corporate.

Auteur : Malek Ghozzi

Related MCP server: mcp-financial-data

Prérequis

• Python 3.10+

• Ollama installé en local avec le modèle qwen2.5-coder:7b

• Fichiers sources :

  • Fichiers XML placés dans le répertoire ./data/xml/

  • Fichier d'indexation placé dans ./data/xmls.csv

  • Dictionnaire de données data_dictionary.md à la racine

Installation

1. Clonez ce dépôt ou copiez les fichiers du projet.

2. Installez les dépendances requises :

   pip install mcp streamlit openai
   pip install -r requirements.txt ```

Démarrage et Utilisation

1. Lancez le modèle local Ollama en arrière-plan : 'ollama run qwen2.5-coder:7b'

2. Dans un nouveau terminal, lancez l'interface Streamlit : 'streamlit run app.py'

Outils Implémentés

Le serveur FastMCP met à disposition du LLM 5 outils d'analyse :

- find_company_xml : Recherche l'entreprise dans l'index CSV via son nom ou SIREN.

- extract_xml_by_keyword : Explore les bilans détaillés pour extraire les valeurs historiques d'un      mot-clé spécifique (gère la déduplication et les valeurs absentes).

- get_company_indicator : Extrait la valeur d'un code indicateur précis (ex: CA00, RN00).

- calculate_profit_margin : Calcule la marge bénéficiaire (Résultat Net / Chiffre d'Affaires).

- lookup_financial_term : Traduit les acronymes financiers via le dictionnaire de données.

Exemples d'Utilisation

L'agent est configuré pour interroger chaque entité séparément et éviter les hallucinations. Testez avec ces requêtes :

- "Quelle est la marge bénéficiaire de TISSOT ETANCHEITE ?"

- "Peux-tu me donner l'indicateur CA00 pour KA BATIMENT ainsi que pour TISSOT ETANCHEITE ?"

- "Recherche le mot-clé 'provisions' dans le fichier de KA BATIMENT."