Skip to main content
Glama
eRom

bible-ecrivain

by eRom
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Bible d'Ecrivain MCP

Serveur MCP standalone pour gerer une bible d'ecrivain — une base de connaissances structuree et cherchable d'un univers narratif.

La bible centralise personnages, lieux, evenements, interactions, regles du monde, recherches et notes. Deux interfaces : outils MCP pour les agents IA, et UI web pour l'humain.

"Bob portait des lunettes a l'eglise du chateau ?"
  --> L'agent interroge la bible
  --> "Oui, Bob portait encore ses lunettes au chapitre 6.
       Il ne s'est fait operer qu'au chapitre 9."

Interface web

Dashboard

Le dashboard affiche les statistiques de la bible avec des cartes illustrees par type d'entite.

Graph

Le graph relationnel permet d'explorer visuellement les connexions entre personnages, lieux, evenements et interactions. Cliquer sur un noeud affiche ses details et ses connexions dans un panneau lateral.

Timeline

La timeline affiche les evenements dans l'ordre narratif, avec les personnages et lieux associes.

Related MCP server: mnemex

Installation

Prerequis : Node.js >= 20, pnpm

git clone <url>
cd barda-mcp-ecrivain-bible
pnpm install
pnpm build

Au premier lancement, le modele d'embeddings (~200 MB) est telecharge automatiquement depuis HuggingFace. C'est une operation unique.

Utilisation

Mode UI (web)

pnpm dev        # Dev : MCP HTTP + UI Vite (hot reload)
pnpm start      # Prod : MCP HTTP + UI statique sur http://localhost:3000

Mode MCP (stdio)

pnpm dev:mcp    # Dev : MCP stdio (pour agents IA)

Configuration MCP

Claude Desktop

Ajouter dans claude_desktop_config.json :

{
  "mcpServers": {
    "bible-ecrivain": {
      "command": "node",
      "args": ["/chemin/vers/barda-mcp-ecrivain-bible/packages/mcp/dist/index.js"]
    }
  }
}

Claude Code

Ajouter dans les settings MCP :

{
  "bible-ecrivain": {
    "command": "node",
    "args": ["/chemin/vers/barda-mcp-ecrivain-bible/packages/mcp/dist/index.js"]
  }
}

Cruchot (barda)

  1. Installation de Cruchot : https://github.com/eRom/cruchot

  2. Télécharger ou cloner le repo puis : Cruchot > Personnaliser > Brigade > Importer un barda

Ou : Ajouter la definition dans la configuration du MCP dans Cruchot :

{
  "command": "node",
  "args": ["/chemin/vers/barda-mcp-ecrivain-bible/packages/mcp/dist/index.js"],
  "transportType": "stdio"
}

Base de donnees personnalisee

Par defaut, la bible est stockee dans packages/mcp/data/bible.db. Pour utiliser un autre chemin :

"args": ["/chemin/vers/dist/index.js", "--db-path", "/chemin/vers/ma-bible.db"]

Fonctionnalites

Domaine

Tools

Description

Personnages

5

Fiches completes (physique, personnalite, background)

Lieux

5

Descriptions, atmosphere, geographie

Evenements

7

Timeline narrative, chronologie, filtres avances

Interactions

6

Relations entre personnages, reseau relationnel

Regles du Monde

5

Magie, technologie, societe, religion...

Recherches

5

Notes de recherche documentaire avec sources

Notes

5

Notes libres avec tags

Recherche

2

Fulltext (FTS5) + semantique (embeddings)

Export / Import

2

Markdown structure + import JSON massif

Embeddings

1

Re-indexation batch (reindex_embeddings)

Utilitaires

5

Backup/restore, stats, doublons, templates

Total

48

La recherche semantique retrouve l'information par le sens, pas juste par les mots exacts. Ideal pour les questions floues comme "je sais plus si Bob avait des problemes de vue".

Pour la documentation complete de chaque outil avec parametres et exemples, voir documentation/mcp.md.

Architecture

UI React (navigateur)                   Agent IA (Claude / Cruchot)
+-------------------+                   +---------------------+
| Dashboard, Graph  |                   | LLM = intelligence  |
| Timeline, CRUD    |                   | Analyse, comprend,  |
| Recherche         |                   | decide quoi stocker |
+--------+----------+                   +----------+----------+
         |                                         |
    HTTP POST /mcp                            stdio JSON-RPC
    (JSON-RPC)                                     |
         |                                         |
         v                                         v
+----------------------------------------------------------+
|                  Bible MCP (ce serveur)                   |
|                                                          |
|  McpServer  -->  48 tools  -->  Drizzle ORM  -->  SQLite |
|                                  FTS5 + Embeddings       |
|                              (1 seul fichier .db)        |
+----------------------------------------------------------+

  • Le client (LLM ou UI) interroge la bible via les memes outils MCP.

  • La bible est la memoire : elle stocke, indexe, et retrouve. Pas de LLM embarque.

  • Un seul fichier bible.db = toute la bible. Backup = copier ce fichier.

Stack technique

Brique

Choix

Runtime

Node.js >= 20, TypeScript (strict)

MCP

@modelcontextprotocol/sdk (stdio + HTTP)

DB

SQLite via better-sqlite3 + Drizzle ORM

Fulltext

SQLite FTS5

Embeddings

@huggingface/transformers (Xenova/multilingual-e5-base, local)

UI

React 19, Vite, Tailwind CSS 4, TanStack Query, Sigma.js

Tests

vitest (90 tests : 61 MCP + 29 UI)

Build

tsup (MCP) + Vite (UI), monorepo pnpm workspaces

Developpement

pnpm dev              # MCP HTTP + UI (dev complet)
pnpm dev:mcp          # MCP stdio uniquement
pnpm dev:ui           # UI Vite dev server (proxy vers MCP)
pnpm build            # Build production (MCP + UI)
pnpm test             # Tous les tests (90)
pnpm --filter @barda/mcp test   # Tests MCP (61)
pnpm --filter @barda/ui test    # Tests UI (29)

Licence

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Writer MCP

    huangjien
    A
    license
    Not graded
    quality
    F
    maintenance
    A Model Context Protocol server that manages character knowledge and relationships for creative writing projects, offering semantic search and AI-powered analysis.
    4
    MIT

  • mnemex

    Daniil-Sokolskiy
    A
    license
    Not graded
    quality
    A
    maintenance
    An MCP server that ingests books into a structured, cross-linked wiki of sources, entities, concepts, and syntheses, managed by an LLM.
    535 npm
    1
    MIT

  • noveletary

    penta2himajin
    A
    license
    A
    quality
    B
    maintenance
    A local MCP server for maintaining internal consistency in fiction writing, with constraint-based fact checking, branching, and author-oracle conflict resolution.
    27
    MIT

  • story-architect-mcp

    PTCuong-1102
    A
    license
    A
    quality
    B
    maintenance
    An MCP server for AI-assisted novel writing that manages project structure, tracks plot holes and foreshadowing, audits timeline continuity, and provides writing analytics and prompt generation.
    21
    MIT