Skip to main content

Un serveur MCP pour accéder à l'API Gallica de la Bibliothèque nationale de France (BnF)

Project description

BnF API Server

Un serveur MCP (Model-Client-Protocol) pour accéder à l'API Gallica de la Bibliothèque nationale de France (BnF) et générer des rapports de recherche séquentiels.

Fonctionnalités

  • Recherche dans Gallica : Recherche de documents, images, cartes et autres ressources dans la bibliothèque numérique Gallica
  • Génération de rapports séquentiels : Création automatique de rapports de recherche structurés sur n'importe quel sujet
  • Intégration de graphiques : Inclusion d'images et de cartes pertinentes dans les rapports générés
  • Citations formatées : Génération automatique de bibliographies avec citations correctement formatées

Installation

Prérequis

  • Python 3.8 ou supérieur
  • Pip (gestionnaire de paquets Python)

Étapes d'installation

  1. Cloner le dépôt:

    git clone https://github.com/votre-nom/mcp-bnf.git
    cd mcp-bnf
    
  2. Installer les dépendances:

    pip install -r requirements.txt
    

Configuration avec Claude Desktop

  1. Installer Claude Desktop si ce n'est pas déjà fait.

  2. Ouvrir la configuration de Claude Desktop:

    • Accéder aux paramètres de Claude Desktop
    • Ouvrir le fichier de configuration (généralement situé à %APPDATA%\Claude\claude_desktop_config.json)
{
 "bnf": {
  "command": "py",
  "args": [
    "c:\\chemin\\vers\\mcp-bnf\\bnf_server.py"
  ],
  "cwd": "c:\\chemin\\vers\\mcp-bnf"
},

Remplacez chemin\\vers\\mcp-bnf par le chemin réel vers votre répertoire d'installation.

  1. Enregistrer le fichier de configuration et redémarrer Claude Desktop

Outils MCP disponibles

Une fois configuré, les outils suivants seront disponibles dans Claude Desktop:

Recherche dans Gallica

Permet de rechercher des documents dans la bibliothèque numérique Gallica de la BnF en utilisant différents critères (titre, auteur, sujet, date, type de document).

Génération de rapports séquentiels

Crée des rapports de recherche complets sur n'importe quel sujet en utilisant les sources de Gallica. Les rapports incluent:

  • Une bibliographie formatée
  • Une introduction
  • Un contexte historique
  • Une analyse
  • Une conclusion
  • Des images et cartes pertinentes (optionnel)

Structure du projet

mcp-bnf/
│
├── bnf_server.py              # Serveur MCP principal
├── requirements.txt           # Dépendances du projet
│
└── bnf_api/                   # Package API BnF
    ├── __init__.py            # Exports du package
    ├── api.py                 # Client API Gallica BnF
    ├── search.py              # Fonctions de recherche
    ├── config.py              # Constantes et configuration
    └── sequential_reporting.py # Outil de génération de rapports séquentiels

Utilisation

Une fois configuré avec Claude Desktop, vous pouvez demander à Claude d'utiliser les outils BnF pour:

  1. Rechercher des documents:

    • "Recherche des livres sur Victor Hugo dans Gallica"
    • "Trouve des cartes de Paris du 19ème siècle"
  2. Générer des rapports:

    • "Crée un rapport sur l'impressionnisme en France"
    • "Génère un rapport sur l'histoire du Liban sous mandat français avec des images"

Développement

Pour contribuer au projet:

  1. Forker le dépôt
  2. Créer une branche pour votre fonctionnalité (git checkout -b feature/nouvelle-fonctionnalite)
  3. Committer vos changements (git commit -am 'Ajouter une nouvelle fonctionnalité')
  4. Pousser vers la branche (git push origin feature/nouvelle-fonctionnalite)
  5. Créer une Pull Request

Licence

Ce projet est open source.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_mcp_bibliotheque_nationale_de_france-0.1.1.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_mcp_bibliotheque_nationale_de_france-0.1.1.tar.gz
Algorithm Hash digest
SHA256 57ee43f27f9a4be9420ec75f1e6cf44a75a99b5c978800e5ef203fbf493c3df7
MD5 d084484960d4d7d3ddb837f918e5441c
BLAKE2b-256 6cd7dc3257662c874f0df1326d4113e3b25ccc18b8e8227c3c2e17b4899087a1

See more details on using hashes here.

File details

Details for the file iflow_mcp_mcp_bibliotheque_nationale_de_france-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_mcp_bibliotheque_nationale_de_france-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bd745009be6651f1179eb89b3751207744996ca2ca619bb30203e6b80e5a371d
MD5 ffe098cc63fe1997c86710c1220453d2
BLAKE2b-256 b1c18474d1d42b0ecd8f83b16a67565d5cdc5823df5a3766fee96f6c3debf0f0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page