📖 MCP Manuels — Assistant PDF pour Claude

Un serveur MCP (Model Context Protocol) qui permet à Claude Desktop de lire et chercher dans vos manuels techniques PDF (manuels d'équipement vidéo, réseau, lumière, fiches techniques…) directement dans la conversation.

Posez une question en langage naturel, Claude va chercher la réponse dans vos PDF et cite la source + le numéro de page.

⚠️ Ce dépôt ne contient aucun manuel. Les PDF des constructeurs sont sous copyright et ne sont pas redistribués ici. Vous ajoutez vos propres PDF dans le dossier manuals/ (voir plus bas).

✨ Fonctionnalités

• Charge automatiquement tous les PDF du dossier manuals/.

• Recherche dans le sommaire (TOC natif du PDF, ou détection heuristique si absent).

• Recherche dans le contenu complet (découpage en chunks).

• 4 outils exposés à Claude :

Related MCP server: MCP-RAG

📦 Prérequis

• Python 3.10+ (testé jusqu'à 3.14). À installer depuis python.org — pas via le Microsoft Store.

• Claude Desktop (téléchargement).

🚀 Installation

# 1. Cloner le dépôt
git clone https://github.com/<votre-compte>/mcp-manuels.git
cd mcp-manuels

# 2. (Recommandé) Créer un environnement virtuel
python -m venv .venv
# Windows :
.venv\Scripts\activate
# macOS / Linux :
source .venv/bin/activate

# 3. Installer les dépendances
python -m pip install -r requirements.txt

💡 Si la commande pip n'est pas reconnue (souvent sous Windows), utilisez toujours python -m pip ….

📁 Ajouter vos manuels

Déposez vos fichiers .pdf directement dans le dossier manuals/ :

mcp-manuels/
└── manuals/
    ├── mon-manuel-1.pdf
    └── mon-manuel-2.pdf

Le serveur les charge tous au démarrage. Plus un PDF a un sommaire natif, meilleure est la recherche (sinon une détection heuristique prend le relais).

⚙️ Configurer Claude Desktop

Claude Desktop lance le serveur via un fichier claude_desktop_config.json.

1. Activer le Mode développeur

Dans Claude Desktop : Réglages → Développeur → activer le Mode développeur. Sans ça, la config des serveurs MCP locaux est ignorée.

2. Trouver / ouvrir le bon fichier de config

Le plus fiable : dans Réglages → Développeur → Edit Config. Ce bouton ouvre le bon fichier, quel que soit votre OS ou votre mode d'installation.

Emplacements par défaut :

🪟 Piège Windows / Microsoft Store : si Claude vient du Store, son %APPDATA% est virtualisé dans …\Packages\…\LocalCache\…. Écrire dans le %APPDATA%\Roaming\Claude classique n'aura aucun effet. Passez toujours par Edit Config pour viser le bon fichier.

3. Ajouter le serveur

Copiez le contenu de claude_desktop_config.example.json et adaptez les chemins :

{
  "mcpServers": {
    "manuels": {
      "command": "python",
      "args": ["/chemin/absolu/vers/mcp-manuels/server.py"],
      "env": {
        "PYTHONUTF8": "1",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

• command : chemin vers votre Python. Si vous utilisez un venv, pointez vers le Python du venv (.venv/Scripts/python.exe sous Windows, .venv/bin/python sous macOS/Linux). Sinon python suffit souvent.

• args : chemin absolu vers server.py.

• Sous Windows, échappez les \ en \\ dans le JSON : "C:\\Users\\...\\server.py".

• Le bloc env fige l'encodage UTF-8 (évite les bugs d'accents sous Windows). Gardez-le.

4. Redémarrer Claude complètement

Fermer la fenêtre ne suffit pas. Windows : clic droit sur l'icône dans la barre des tâches → Quitter. macOS : ⌘Q. Puis relancer.

5. Vérifier

Cliquez sur l'icône 🔨 (outils) dans la zone de saisie : le serveur manuels doit apparaître avec ses 4 outils. Testez avec :

« liste les manuels disponibles »

💬 Exemples d'usage

• « Quels manuels sont disponibles ? »

• « Comment configurer la redondance sur le MX30 ? »

• « Cherche les sections sur le backup réseau »

• « Donne-moi le texte de la page 24 du manuel MX30 »

🛠️ Dépannage

Lire les logs (nom du serveur = clé dans la config, ici manuels) :

• Windows : %APPDATA%\Claude\logs\mcp-server-manuels.log (ou le chemin virtualisé Store)

• macOS : ~/Library/Logs/Claude/mcp-server-manuels.log

Tester le serveur seul (hors Claude) :

python server.py

Il doit afficher [INFO] Chargement : … pour chaque PDF puis [INFO] Total : …, et se figer (il attend Claude). Ctrl+C pour quitter. Si un warning ou une erreur apparaît ici, le problème est dans le serveur ou les PDF, pas dans Claude.

📜 Licence

MIT — voir LICENSE. Le code est libre ; les manuels PDF que vous y ajoutez restent la propriété de leurs éditeurs respectifs.