🛡️ Scan Your AI Toolkit

Open-Source-Tools für KI-Governance. Jedes Tool funktioniert eigenständig als MCP-Server oder CLI – zusammen bilden sie ein Governance-Netzwerk.

scan_your_ai_toolkit MCP server

CodeQL npm scope License MCP Conformance PRs Welcome

Entwickelt von Maiife — Enterprise AI Control Plane.

Tools

Paket	Beschreibung	Veröffentlicht
`@maiife-ai-pub/shared`	Gemeinsame Typen und Formatierer für alle Toolkit-Pakete	✅
`@maiife-ai-pub/probe`	KI-Umgebungsscanner — entdeckt IDE-Erweiterungen, MCP-Server, Agent-Frameworks, API-Schlüssel, lokale Modelle	✅
`@maiife-ai-pub/mcp-audit`	MCP-Server-Sicherheitsscanner — bewertet Konfigurationen hinsichtlich Berechtigungen, Datensensibilität, Wirkungsradius	✅
`@maiife-ai-pub/ai-stack`	"Was ist Ihr KI-Stack?" — teilbare Profilkarte Ihres KI-Toolkits	✅
`@maiife-ai-pub/mcp-doctor`	MCP-Gesundheitscheck & Auto-Fixer — der "brew doctor" für Ihr MCP-Setup	✅
`@maiife-ai-pub/ai-journal`	Persönliches KI-Nutzungstagebuch — verfolgen Sie Ihre KI-Nutzung und erhalten Sie reflektierende Einblicke	✅
`@maiife-ai-pub/context-sync`	Toolübergreifende KI-Speichersynchronisierung — eine context.json, synchronisiert mit Cursor, Claude, MCP	✅
`@maiife-ai-pub/prompt-score`	Prompt-Qualitätsanalysator — bewerten, verbessern und prüfen Sie Ihre KI-Prompts	✅
`@maiife-ai-pub/eval`	LLM-as-Judge-Evaluierungs-Engine — bewerten Sie Agenten-Ausgaben mit strukturierten Rubriken	✅
`@maiife-ai-pub/trace`	Agent-Workflow-Tracer — verfolgen, betrachten und analysieren Sie Ausführungsspannen	✅
`@maiife-ai-pub/cost`	KI-Ausgabenrechner + Optimierer — einheitlicher Kostenbericht über Anbieter hinweg	✅
`@maiife-ai-pub/prompt-craft`	Gamifizierter Prompt-Coach — Level, Streaks, Abzeichen für Prompt-Verbesserungen	✅
`@maiife-ai-pub/sub-audit`	Persönlicher KI-Abonnement-Prüfer — finden Sie Verschwendung bei Ihren KI-Ausgaben	✅
`@maiife-ai-pub/model-match`	Persönlicher Modell-Empfehler — finden Sie das beste Modell für IHRE Aufgaben	✅
`@maiife-ai-pub/weekly-ai-report`	KI-Wochenrückblick — Spotify Wrapped für Ihre KI-Nutzung, wöchentlich	✅

Schnellstart

# Scan your AI environment
npx @maiife-ai-pub/probe scan

# Audit your MCP server security
npx @maiife-ai-pub/mcp-audit scan

# Generate your AI Stack profile card
npx @maiife-ai-pub/ai-stack --format svg --output my-stack.svg

# Health check your MCP servers
npx @maiife-ai-pub/mcp-doctor check

# Log an AI interaction
npx @maiife-ai-pub/ai-journal log --tool claude --task coding --duration 30

# Sync AI context across tools
npx @maiife-ai-pub/context-sync push

# Score your AI prompts
npx @maiife-ai-pub/prompt-score analyze --input prompt.txt

# Evaluate agent outputs with rubrics
npx @maiife-ai-pub/eval score --rubric code-review --input review.txt

# Trace agent workflows
npx @maiife-ai-pub/trace list --days 7

# Track AI spend across vendors
npx @maiife-ai-pub/cost report --period last-30d

# Gamified prompt coaching
npx @maiife-ai-pub/prompt-craft score --input prompt.txt

# Audit AI subscriptions for waste
npx @maiife-ai-pub/sub-audit

# Find the best model for your tasks
npx @maiife-ai-pub/model-match recommend --task coding

# Generate your AI week in review
npx @maiife-ai-pub/weekly-ai-report generate

Verwendung als MCP-Server

Jedes Tool mit einem MCP-Server kann zu Claude Desktop, Cursor oder jedem MCP-kompatiblen Client hinzugefügt werden. Jedes Tool stellt Funktionen über den stdio-Transport bereit.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "maiife-probe": {
      "command": "npx",
      "args": ["@maiife-ai-pub/probe", "mcp"]
    },
    "maiife-mcp-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-audit", "mcp"]
    },
    "maiife-mcp-doctor": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-doctor", "mcp"]
    },
    "maiife-eval": {
      "command": "npx",
      "args": ["@maiife-ai-pub/eval", "mcp"]
    },
    "maiife-prompt-score": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-score", "mcp"]
    },
    "maiife-prompt-craft": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-craft", "mcp"]
    },
    "maiife-cost": {
      "command": "npx",
      "args": ["@maiife-ai-pub/cost", "mcp"]
    },
    "maiife-model-match": {
      "command": "npx",
      "args": ["@maiife-ai-pub/model-match", "mcp"]
    },
    "maiife-ai-stack": {
      "command": "npx",
      "args": ["@maiife-ai-pub/ai-stack", "mcp"]
    },
    "maiife-context-sync": {
      "command": "npx",
      "args": ["@maiife-ai-pub/context-sync", "mcp"]
    },
    "maiife-sub-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/sub-audit", "mcp"]
    },
    "maiife-trace": {
      "command": "npx",
      "args": ["@maiife-ai-pub/trace", "mcp"]
    }
  }
}

Wählen Sie die benötigten Tools aus – Sie müssen nicht alle hinzufügen. Nach der Konfiguration kann Claude Tools wie probe_scan, mcp_audit_scan, eval_score, prompt_score_analyze, cost_report und mehr direkt aus dem Chat aufrufen.

Ausführung mit Docker

Jeder MCP-Server wird als Docker-Image auf GHCR veröffentlicht. Nützlich für isolierte Umgebungen oder die Glama-Integration.

# Pull and run any server
docker run -i ghcr.io/sakthivelchan89/maiife-probe
docker run -i ghcr.io/sakthivelchan89/maiife-mcp-audit
docker run -i ghcr.io/sakthivelchan89/maiife-eval
# ... same pattern for all 12 packages

# Or build from source
docker build -f packages/probe/Dockerfile -t maiife-probe .
docker run -i maiife-probe

Docker-Images verwenden den stdio-Transport (keine Ports freigegeben). Verwenden Sie -i für die interaktive stdin/stdout-Kommunikation mit MCP-Clients.

Qualität & Compliance

Dieses Toolkit zielt darauf ab, die Qualitätsstandards von MCP Tier 1 zu erfüllen (gemäß MCP SEP-1730). Das bedeutet:

Dimension	Status
Lizenz	Apache 2.0 — kanonisch SPDX, OSI-genehmigt
Transport	nur stdio (keine Netzwerkfreigabe)
CI/CD	GitHub Actions: Lint + Typ-Prüfung + Tests auf Node 18, 20, 22
Testabdeckung	vitest + `@vitest/coverage-v8`, pro Paket gemeldet
MCP-Konformität	Protokoll-Konformitätssuite für alle 12 MCP-Server
Sicherheitsscan	CodeQL (wöchentlich + bei PR), Dependabot (wöchentlich)
Schwachstellenreaktion	48h KRITISCH / 7d HOCH (siehe DEPENDENCY_POLICY.md)
Issue-Triage SLA	2 Werktage (siehe CONTRIBUTING.md)
Versionierung	SemVer, im Gleichschritt über Pakete hinweg, CHANGELOG.md
Lieferkette	`pnpm-lock.yaml` committet, `--frozen-lockfile` in CI
Container-Sicherheit	Nicht-Root-Benutzer, keine offenen Ports, GHCR-signiert

Konformitätstest-Suite

Jeder MCP-Server in diesem Repository wird anhand des MCP-Protokollvertrags validiert:

✅ stdio-Transport-Invariante (keine Nicht-JSON-Ausgabe auf stdout)
✅ initialize-Handshake antwortet mit gültigen serverInfo + Fähigkeiten
✅ tools/list gibt den dokumentierten Tool-Satz zurück
✅ Alle inputSchema-Felder der Tools sind gültige JSON-Schema-Objekte
✅ Unbekannte Tool-Aufrufe geben strukturierte Fehler zurück (keine Abstürze)

Führen Sie die Suite aus:

pnpm test:conformance      # all packages
cd packages/probe && pnpm test:conformance   # single package

Dokumentation

SECURITY.md — Richtlinie zur Meldung von Schwachstellen
CONTRIBUTING.md — Richtlinien für Issues/PRs und SLAs
CHANGELOG.md — Versionsverlauf (Keep a Changelog-Format)
DEPENDENCY_POLICY.md — Kriterien für die Abhängigkeitsauswahl & Patch-SLAs

Mitwirken

Beiträge sind willkommen! Lesen Sie CONTRIBUTING.md für den vollständigen Leitfaden. Kurzversion:

Forken Sie das Repo auf GitHub
Erstellen Sie einen Branch: git checkout -b feat/my-improvement
Nehmen Sie Ihre Änderungen vor — jedes Paket befindet sich in packages/<name>/
Führen Sie Tests aus: pnpm test && pnpm test:conformance
Öffnen Sie einen PR gegen main — beschreiben Sie, was Sie geändert haben und warum

Bitte folgen Sie dem bestehenden Code-Stil (TypeScript, ESM, Vitest für Tests). Jedes Paket sollte, wo zutreffend, sowohl als CLI als auch als MCP-Server funktionieren.

Lizenz

Apache 2.0 — frei zu verwenden, zu ändern und zu verteilen.

Teil der Maiife Plattform — Enterprise AI Control Plane.

scan_your_ai_toolkit