Serveur MCP Dhamma.Gift
Commit 14 nov. 2026Permet de rechercher et de lire les textes du Canon Pāli avec des traductions russes et anglaises grâce à une recherche plein texte propulsée par SQLite.
Aussi connu sous dhammagift/dg-node, dg-node
- Étoiles
- 1
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.0.0
- Dernier commit
- 14 nov. 2026
- Licence
- —
Qu'est-ce que Dhamma.Gift MCP ?
Dhamma.Gift est un serveur MCP. Permet de rechercher et de lire les textes du Canon Pāli avec des traductions russes et anglaises grâce à une recherche plein texte propulsée par SQLite.
Résumé généré à partir du README du projet
À propos du MCP server Dhamma.Gift
L'accès et la recherche de textes du Canon Pāli via des traductions anglaises et russes constituent la fonction principale de ce serveur. Il fournit un backend spécialisé pour la lecture de textes sacrés en utilisant les traductions SuttaCentral Bilara et DhammaGift. Les développeurs et les chercheurs peuvent utiliser le moteur FTS5 basé sur SQLite pour effectuer des recherches plein texte dans l'ensemble du canon, en récupérant des segments spécifiques ou des suttas entiers via des structures d'URL propres telles que /dn22 ou /dn22:12.1.
Le système fonctionne localement en lisant les données directement sur le disque, ce qui nécessite une étape de build pour générer la base de données SQLite dg.db à partir des données Bilara. Il prend en charge divers environnements, notamment Windows, Termux et les serveurs locaux, grâce à une résolution automatique des chemins pour les miroirs hors ligne. Bien qu'il inclue des services hérités basés sur Express, l'environnement de production moderne utilise Fastify pour gérer les requêtes de recherche, les routes du lecteur et les ressources statiques.
Les utilisateurs peuvent basculer entre les modes de contenu Pāli, russe et anglais pour répondre à leurs besoins d'étude. Le serveur gère les liens sensibles aux segments et les cibles de défilement, garantissant que des versets ou des sections spécifiques sont facilement accessibles dans l'interface du lecteur.
Ce que vous pouvez faire avec
- 1Rechercher dans le Canon PāliTrouvez des termes ou des noms spécifiques dans l'ensemble du canon en utilisant les traductions russes ou anglaises.
- 2Lire des segments de sutta spécifiquesNaviguez directement vers un verset ou un segment spécifique au sein d'un sutta grâce au routage par URL propre.
- 3Basculer entre les langues de traductionPassez de la vue du texte original en Pāli à ses traductions russes ou anglaises.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Dhamma.Gift MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Dhamma.Gift MCP dans Claude Code
$ claude mcp add --transport http dg-node https://api.dhamma.gift/mcpInstaller Dhamma.Gift MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"dg-node": {
"url": "https://api.dhamma.gift/mcp"
}
}
}Installer Dhamma.Gift MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"dg-node": {
"type": "http",
"url": "https://api.dhamma.gift/mcp"
}
}
}Installer Dhamma.Gift MCP dans VS Code CLI
$ code --add-mcp '{"name":"dg-node","type":"http","url":"https://api.dhamma.gift/mcp"}'Installer Dhamma.Gift MCP dans Codex
$ codex mcp add dg-node --url https://api.dhamma.gift/mcpInstaller Dhamma.Gift MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.dg-node] url = "https://api.dhamma.gift/mcp"
Installer Dhamma.Gift MCP dans Gemini CLI
$ gemini mcp add -s user --transport http dg-node https://api.dhamma.gift/mcpInstaller Dhamma.Gift MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"dg-node": {
"url": "https://api.dhamma.gift/mcp",
"type": "http"
}
}
}Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibledhammagift/dg-node is public and reachablegithub.com/dhammagift/dg-node ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)No licenseFaille
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/dhammagift/dg-node ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 397 msRéussi
README
Voir sur GitHubdg-node
Node.js backend for searching and reading Pāli Canon texts using SuttaCentral Bilara and DhammaGift translations.
This project powers the search index, reader endpoints, static assets, and compatibility layer for the legacy Dhamma.Gift stack. The production server runs on Fastify; the older Express-based implementation is kept only for legacy support.
Architecture and development rules: CLAUDE.md
Features
- Search across the Pāli Canon with SQLite/FTS5
- Reader routes for clean URLs such as
/dn22and/dn22:12.1 - Segment-aware links and scroll targets
- Support for offline mirror data and environment-based path resolution
- Legacy compatibility with older PHP/Apache frontends
Quick start
git pull
npm install
npm run build-search-db # build dg.db (SQLite/FTS5) from fresh Bilara data
npm start # run the production server (dg-fastify.js), port 3000
build-search-db should be rerun whenever source texts or translations change on disk. The server reads data directly from disk and rebuilds the search index as needed.
Data paths such as SC_BILARA, DG_OFFLINE, and offline mirrors are resolved automatically based on the runtime environment (Termux, Windows development, local server, etc.).
unused/dg-light.js and unused/dblight.js (npm run start:express) are legacy Express + grep services and are not used in production. See CLAUDE.md for details.
Deployment checks
curl "http://localhost:3000/search?q=kacchapa&scope=dhamma&langs=ru,en"
curl -I "http://localhost:3000/assets/js/datatables/datatables.min.js" # 200 from public/overrides/js/datatables, not from the legacy repo
curl -I "http://localhost:3000/dn22" # reader via clean URL
curl -I "http://localhost:3000/dn22:10.5" # segment link (scroll to 10.5)
Manual browser checks:
/nodejs/res/?q=kacchapa&scope=dhamma— search, DataTables, export/dn22— full-text reader- Pāli / Russian toggle (three modes: Pāli + translation → Pāli only → translation only) — should actually hide/show content correctly
/?q=dn22#12.1(legacy format) — should continue to work alongside/dn22:12.1
Deployment notes for Apache/PHP
If the public Dhamma.Gift site is currently hosted by Apache/PHP while Node runs as a separate backend proxied only to /search, note the following:
- search requests may route to the Node backend
- static files and reader routes may still be served by Apache/PHP
- root-domain routing can differ from the local development environment
dg-fastifyis the modern backend, while legacy PHP pages remain in parallel for compatibility
Project structure
dg-fastify.js — production server (Fastify + SQLite/FTS5, dg.db): /search, /api/text/:suttaId,
static files (search/, reader/, siteroot/assets/), offline mirrors,
clean URLs (/dn22, /dn22:12.1)
unused/dg-light.js — legacy Express + grep server, not used in production (see CLAUDE.md)
unused/dblight.js — build script for dg-light.js → dg_db_light.json (legacy, not needed with dg.db)
search/ — search page (DataTables); legacy URL remains /nodejs/res/... (see CLAUDE.md)
reader/ — reader frontend (reader-template.html + megareader.js)
configs/ — project JSON configs (openapi, reader/*, search/*), see CLAUDE.md
docs/ — project documentation and compatibility notes (SPA plans, backward compatibility)
siteroot/ — root-site publication: assets/ (legacy assets), 4nt/config/login/,
memo/read (legacy tools), see CLAUDE.md
License
See the repository license and project-specific notes in the root of the project.
Questions sur Dhamma.Gift MCP
Comment ajouter Dhamma.Gift MCP à Claude Code ?
Exécutez claude mcp add --transport http dg-node https://api.dhamma.gift/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Dhamma.Gift MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment construire la base de données de recherche ?
Vous pouvez construire l'index de recherche SQLite/FTS5 à partir des données Bilara fraîches en exécutant la commande 'npm run build-search-db'.
Le serveur prend-il en charge les liens spécifiques aux segments ?
Oui, le serveur prend en charge des URL propres pour des segments spécifiques, comme /dn22:12.1, ce qui permet de faire défiler la page jusqu'à des cibles précises.