bc-source-mcp

Serveur MCP (Model Context Protocol) qui expose les sources de Microsoft Dynamics 365 Business Central — toutes versions (BC v23 -> v29), toutes localisations (W1 + 47 pays), avec et sans vNext — a des agents IA comme Claude Code et Claude Desktop.

Vous voulez juste l'installer pour l'utiliser ? Voir INSTALL.md.

Donnees pompees du depot communautaire StefanMaron/MSDyn365BC.Sandbox.Code.History. Le serveur fait un partial clone (~1,6 Go au lieu de 50-100 Go) puis indexe les objets AL dans une base SQLite locale, ce qui permet des lookups a <100 ms.

A quoi ca sert

Pour un agent IA qui code en AL, devoir deviner la signature d'une procedure standard, le nom exact d'un event publisher ou la liste des champs d'une table BC est une cause majeure d'hallucinations. Ce MCP donne a l'agent un acces structure et verifie au code source BC, sans dependre de sa memoire d'entrainement.

Exemples d'usages typiques :

• Trouver les IntegrationEvent a souscrire dans Approvals Mgmt. en v27
• Recuperer la definition exacte de la table Customer en localisation FR vs W1
• Chercher tous les usages d'un motif de code a travers la Base Application
• Comparer la presence d'un objet entre plusieurs versions

Les 14 tools exposes

| Categorie | Tool | Description | |---|---|---| | Decouverte | bc_list_branches | Liste les 545 branches du repo upstream | | Decouverte | bc_list_versions | Versions BC (23 -> 29, avec ou sans vNext) | | Decouverte | bc_list_localizations | 47 codes pays + W1 | | Decouverte | bc_list_apps | Apps top-level d'une branche | | Decouverte | bc_list_objects | Objets AL filtres (type / app / pattern) avec pagination | | Decouverte | bc_find_object_across_branches | Presence d'un objet a travers les branches indexees | | Lookup | bc_get_object | Source AL d'un objet (avec line_start/line_end/include_source pour les gros objets) | | Lookup | bc_get_event_publishers | Events publies par un objet (IntegrationEvent, BusinessEvent, InternalEvent) | | Lookup | bc_get_procedure | Procedure ciblee avec signature, body, attributes | | Recherche | bc_search_code | Recherche regex via ripgrep, scope par app/type (avec timeout de 30s) | | Recherche | bc_search_fts | Full-text FTS5 cross-branch, syntaxe FTS5 (tokens, phrases, prefix*) avec snippets | | Admin | bc_refresh | Re-fetch + re-index d'une ou toutes les branches | | Admin | bc_cache_status | Disk usage + branches indexees | | Admin | bc_prune_cache | Suppression selective de worktrees |

Note : apres une mise a jour vers une version qui introduit l'index FTS5, les branches deja indexees ne sont pas automatiquement re-indexees. Lancez bc_refresh sur les branches que vous voulez voir apparaitre dans bc_search_fts.

Installation

Voie 1 — via NPM (recommande)

Claude Code :

powershell claude mcp add bc-source-mcp -s user -- npx -y bc-source-mcp

Claude Desktop — editez %APPDATA%\Claude\claude_desktop_config.json :

json { "mcpServers": { "bc-source-mcp": { "command": "npx", "args": ["-y", "bc-source-mcp"] } } }

Le binaire bc-source-mcp est expose par le bin de package.json. npx -y recupere la derniere version a chaque demarrage (cache npm); pour epingler une version, utilisez [email protected].

Voie 2 — clone GitHub (pour contribuer)

powershell git clone https://github.com/glachana/bc-source-mcp.git cd bc-source-mcp npm install npm run build .\scripts\setup.ps1 -ClaudeCode -ClaudeDesktop

Guide utilisateur complet : INSTALL.md.

Configuration

Variables d'environnement utilisables (toutes optionnelles) :

| Variable | Defaut | Description | |---|---|---| | BC_SOURCE_CACHE_DIR | ~/.bc-source-mcp/ | Cache local (partial clone + worktrees + SQLite). ~2-5 Go selon les versions indexees. | | BC_SOURCE_REPO_URL | StefanMaron/MSDyn365BC.Sandbox.Code.History | URL du repo upstream -- override si vous avez un fork | | BC_SOURCE_LOG_LEVEL | info | trace/debug/info/warn/error/fatal |

Pour les passer a Claude Code : ajoutez -e KEY=VALUE a la commande claude mcp add. Pour Claude Desktop : ajoutez une cle env a l'entree mcpServers.

Maintenance

Il y a deux choses distinctes a garder a jour :

MAJ du serveur

• Installation NPM : npm install -g bc-source-mcp@latest (ou retirer le cache npx)
• Installation depuis Git : .\scripts\update.ps1

Ensuite redemarrez Claude Code/Desktop.

MAJ des donnees BC en cache (sources upstream)

Independamment du code du serveur, vous voulez parfois rafraichir les sources BC en cache pour recuperer les derniers commits upstream (par ex. quand Microsoft publie un nouveau cumulative update).

Dans votre client MCP, demandez a Claude :

Avec bc_refresh, rafraichis l'index de la branche w1-26.

Ou pour toutes les branches indexees :

Avec bc_refresh sans parametre, rafraichis toutes les branches.

Le tool bc_cache_status vous donne a tout moment la taille disque + la liste des branches en cache.

Developpement

powershell npm install npm run build # tsc -> dist/ npm test # vitest npm run inspector # MCP Inspector pour tester en interactif

Tests : 54 unit tests sur les parsers AL (object header, events, procedures) et le branch resolver.

Architecture

Le serveur maintient un cache local sous ~/.bc-source-mcp/ :

~/.bc-source-mcp/ +-- repo/ Partial clone Git unique (--filter=blob:none, ~1,6 Go) +-- worktrees/<branch>/ Worktrees Git checkout-es a la demande +-- index.db SQLite : branches, apps, objects, event_publishers

A la premiere requete sur une branche (ex. w1-26) :

1. git fetch origin <branch> (blobs telecharges a la demande grace au partial clone)
2. git worktree add du checkout complet de la branche
3. Walk recursif de tous les *.al -> parsing header + events -> insert SQLite
4. Lookups ulterieurs : tout en RAM/SQLite, <100 ms

Branches du repo upstream : 545 (47 localisations x 7 versions, avec ou sans vNext). Sur w1-26 : ~15 000 objets AL et ~22 000 event publishers indexes en ~10 s.

Stack

• TypeScript + Node.js 20+
• @modelcontextprotocol/sdk (transport stdio)
• better-sqlite3 (index local)
• simple-git (partial clone + worktrees)
• @vscode/ripgrep (recherche full-text)
• zod (schemas) + pino (logs sur stderr)

Contribuer

Issues et PR bienvenues sur https://github.com/glachana/bc-source-mcp.

Le projet utilise Conventional Commits + release-please pour le versioning et la publication npm automatiques. Lire CONTRIBUTING.md avant d'ouvrir une PR.

Roadmap d'ameliorations en cours : IMPROVEMENTS.md.

Licence

MIT (c) 2026 Gabriel Lachana.