Logo
BlogPortfolioGadgets

Rule Intelligence MCP – Smarte Rulebase-Analyse für moderne Teams

2025-04-29

Rule Intelligence MCP – Smarte Rulebase-Analyse für moderne Teams

Autor: Michael Tittmar
Datum: 29.04.2025

Motivation

Wer viele Coding-Guidelines, Security- oder Architekturregeln im Projekt hat, kennt das Problem:
Regelwerke werden schnell unübersichtlich, doppelt, widersprüchlich oder schlicht vergessen.
Manuelle Pflege ist fehleranfällig – und automatisierte Checks fehlen oft.

Genau hier setzt mein neues Open-Source-Tool an:
rule-intelligence-mcp – ein intelligenter Rulebase-Analyzer für Node.js/TypeScript!

Was kann das Tool?

  • Rulebase-Analyse:
    Findet fehlende Kategorien, doppelte Regeln, leere Inhalte und mehr.
  • Schema-Validierung:
    Prüft, ob alle Regeln dem gewünschten JSON-Schema entsprechen.
  • CLI-Komfort:
    Filtere Regeln nach Status oder Tags, Ausgabe als JSON oder Markdown.
  • Memory-Bank:
    Protokolliert alle Edits und LLM-Vorschläge für Nachvollziehbarkeit.
  • LLM-Integration (optional):
    Lass dir von OpenAI automatisch neue Regeln vorschlagen!
  • Watch-Mode (optional):
    Analysiert die Rulebase automatisch bei jeder Änderung.

Architektur & Technik

  • Node.js + TypeScript: Moderne, typsichere Codebasis.
  • CLI mit yargs: Intuitive Befehle, viele Optionen.
  • AJV: Schnelle und strikte JSON-Schema-Validierung.
  • Jest: Umfangreiche Unit- und Integrationstests.
  • Optionales Laden von Features:
    LLM und Watch-Mode werden nur geladen, wenn du sie brauchst – das hält node_modules schlank!

Installation & Quickstart

git clone https://github.com/micha-gh/rule-intelligence-mcp.git
cd rule-intelligence-mcp
npm install

Beispiel:

# Analysiere deine Rulebase
rule-intelligence-mcp analyze -r myrules.json --format md

# Editiere eine Regel
rule-intelligence-mcp edit rule-2 --title "Use parameterized queries"

# Memory-Bank anzeigen
rule-intelligence-mcp memory:list

# LLM-Vorschläge (optional, benötigt openai)
npm install openai
rule-intelligence-mcp suggest -r myrules.json

# Watch-Mode (optional, benötigt chokidar)
npm install chokidar
rule-intelligence-mcp watch -r myrules.json

Optional Features

  • LLM Suggest:
    Installiere openai nur, wenn du wirklich LLM-Vorschläge willst.
  • Watch-Mode:
    Installiere chokidar nur, wenn du Live-Analysen bei Dateiänderung brauchst.

Das Tool prüft automatisch, ob die Pakete installiert sind, und gibt einen klaren Hinweis, falls nicht.

Testing & Qualität

  • Vollautomatische Tests:
    npm test prüft alle Kernfunktionen und CLI-Kommandos.
  • Edge-Case-Rulebase:
    Beispiel-Rulebase enthält doppelte IDs, fehlende Felder, verschiedene Status etc.
  • Memory-Bank:
    Alle Edits und LLM-Vorschläge werden mit Zeitstempel gespeichert.

Fazit

Mit rule-intelligence-mcp kannst du Rulebases endlich wie echten Code behandeln:
Automatisiert, nachvollziehbar, testbar und erweiterbar.

Das Tool ist Open Source, modular und wächst mit deinen Anforderungen.
Probier's aus – Feedback und Pull Requests sind willkommen!

Repo:
https://github.com/micha-gh/rule-intelligence-mcp

Viel Spaß beim Automatisieren eurer Coding-Guidelines! 🚀