Palamède — Serveur MCP

Présentation

Ce serveur expose une knowledge base personnelle via le protocole MCP (Model Context Protocol). Tout modèle IA compatible — Claude Code, claude.ai, Gemini CLI — peut lire, écrire et rechercher dans la base de connaissances à travers 7 outils standardisés.

🔌 Endpoint MCP

https://mcp.palamede.eu/mcp
Transport SSE + Streamable HTTP (2025-03-26)

🔐 Authentification

Claude Code — Bearer JWT dans .mcp.json
claude.ai — OAuth 2.1 PKCE, mot de passe mcpBerlin123

📂 Racine Knowledge Base

/opt/knowledge-base/
Versionnée via Git · Recherche ripgrep

Outils disponibles

Outil	Description	Paramètres
`read_index`	Lit `_index.md` racine — point d'entrée obligatoire	aucun
`read_projects_index`	Lit `projets/_index.yaml`	aucun
`list_directory`	Liste le contenu d'un dossier	`path`
`read_file`	Lit un fichier Markdown	`path`
`write_file`	Crée ou écrase un fichier (commit Git auto)	`path`, `content`
`append_to_file`	Ajoute du contenu à la fin d'un fichier	`path`, `content`
`search`	Recherche full-text via ripgrep	`query`, `directory` (opt.)

Structure de la Knowledge Base

/opt/knowledge-base/ ├── prompts/ # Prompts réutilisables (code, rédaction, analyse, recherche) ├── personas/ # Profils de personas IA (Gems, Claude, Gemini…) ├── structure/ # Guides techniques, infra, troubleshooting ├── projets/ # Projets actifs et archives │ ├── _index.yaml # Index machine-readable │ └── _template/ # Templates cdc.md et memoire.md └── notes/ # Idées et expérimentations

Chaque dossier contient un _index.md listant son contenu. Tout fichier suit un frontmatter YAML standard : titre, type, statut, tags, date_creation, date_maj, résumé.

Mode opératoire pour les modèles IA

Séquence recommandée à chaque session :

1. read_index                        → comprendre la structure globale
2. read_projects_index               → si le sujet concerne un projet
3. list_directory("section/")        → explorer une section précise
4. read_file("section/fichier.md")   → lire un contenu ciblé
5. search("mot-clé")                 → localiser par contenu
6. write_file(path, content)         → créer ou mettre à jour
7. append_to_file(path, content)     → ajouter sans écraser

Règles d'usage

📌

Toujours commencer par read_index — c'est le point d'entrée. Ne jamais deviner un chemin sans avoir lu l'index.

📋

Frontmatter obligatoire — tout fichier .md créé doit commencer par le bloc YAML : titre, type, statut, tags, date_creation, date_maj, résumé.

📅

Mettre à jour date_maj à chaque modification d'un fichier existant.

🗂️

Tout nouveau projet doit avoir une entrée dans projets/_index.yaml et idéalement un fichier projets/nom-projet.md (fiche) et projets/nom-projet-memoire.md (journal).

🔤

Nommage : minuscules, tirets, pas d'accents ni d'espaces. Exemples : mon-projet.md, guide-usage.md.

🌿

Git automatique — write_file et append_to_file créent un commit Git automatiquement. Pas besoin de commande manuelle.

🔍

Vérifier avant d'écrire — utiliser search ou list_directory pour confirmer qu'un fichier n'existe pas déjà avant d'en créer un nouveau.

Intégrations

Client	Méthode	Config	Statut
Claude Code (VSCode / CLI)	Bearer JWT	`.mcp.json` à la racine du projet	Actif
claude.ai	OAuth 2.1 PKCE	Connecteur personnalisé → mot de passe `mcpBerlin123`	En cours
Gemini CLI	Compatible MCP	—	Non testé

Endpoints OAuth 2.1

Endpoint	Rôle
`GET /.well-known/oauth-protected-resource`	Metadata ressource protégée (RFC 9728)
`GET /.well-known/oauth-authorization-server`	Discovery OAuth (RFC 8414)
`POST /oauth/register`	Enregistrement dynamique client (RFC 7591)
`GET /oauth/authorize`	Page d'autorisation (formulaire mot de passe)
`POST /oauth/token`	Échange code PKCE → JWT 1 an
`POST /admin/token`	Génération token statique (localhost uniquement)