Skip to main content

MCP server for accessing the Gallica API of the 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_kryzo_mcp_bibliotheque_nationale_de_france-1.0.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_kryzo_mcp_bibliotheque_nationale_de_france-1.0.0.tar.gz
  • Upload date:
  • Size: 12.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_kryzo_mcp_bibliotheque_nationale_de_france-1.0.0.tar.gz
Algorithm Hash digest
SHA256 47284ff8c7aad84e9ff9722fd906a8618a551e0fef5d53ea071ded54f5faabf4
MD5 2f63cfd7898f6d0f4a14cc78d60463d9
BLAKE2b-256 d6b08e14ff5650dfb5d70f22ec1d3a9e8c31aec32c93575d1ab5afecf313c127

See more details on using hashes here.

File details

Details for the file iflow_mcp_kryzo_mcp_bibliotheque_nationale_de_france-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_kryzo_mcp_bibliotheque_nationale_de_france-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 21.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_kryzo_mcp_bibliotheque_nationale_de_france-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4439e25add72b5dafc9f2fb49d9f393350746916b0564d9ff9bb72cff4e67362
MD5 8e8a98888f32fbac0e2ec62b0e90b989
BLAKE2b-256 fb0603974a63d6006ee88c8d802ac9dacf3a100f9078131eb894c4d32adf8ed3

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