Crystal MCP-Server

Eine spezialisierte, mit TypeScript erstellte Model Context Protocol (MCP)-Serverimplementierung, die KI-Assistenten leistungsstarke Tools für die Verwaltung und Arbeit mit Crystal-Artefakten bietet – strukturierte Datencontainer für komplexe Analysen, Code und Wissen.

🔮 Was sind Kristalle?

Crystals sind strukturierte Datencontainer, die komplexe Analyseergebnisse, Codeartefakte, mathematische Formulierungen und andere anspruchsvolle Inhalte enthalten können. Sie bieten eine standardisierte Möglichkeit zum Speichern, Exportieren und Reimportieren komplexer Arbeitsprodukte in verschiedenen KI-Konversationen und -Kontexten.

Related MCP server: Vibe Coder MCP

🚀 Funktionen

🛠️ Kristallverwaltungstools

• import_crystal_spec - Kristallspezifikationsprotokolle importieren

• import_codex - Importieren Sie Codex-Dateien für Mechanismusbewusstsein und Agentenprotokolle

• export_crystal - Exportieren Sie Inhalte als Crystal-Artefakte mit automatischer Erkennung

• import_crystal - Importieren und Rekonstruieren von Kristallartefakten nach UUID

• list_crystals - Listet alle verfügbaren Kristallartefakte auf

🔧 Schlüsselfunktionen

• Automatische Erkennung : Automatisches Erkennen und Exportieren von Crystal-würdigem Inhalt aus dem Konversationskontext

• Versionskontrolle : Unterstützung für mehrere Versionen der Kristallspezifikation

• UUID-Verwaltung : Eindeutiges Identifikationssystem für Kristallartefakte

• Sicherer Speicher : Sichere Dateivorgänge innerhalb der Projektgrenzen

• Metadatenverfolgung : Umfassende Verfolgung der Kristallentstehung und -eigenschaften

📋 Voraussetzungen

• Node.js 18 oder höher

• npm oder yarn Paketmanager

🔧 Installation

1. Installieren Sie Abhängigkeiten:

   npm install

2. Erstellen Sie den Server (optional):

   npm run mcp:build

🚀 Verwendung

Entwicklungsmodus

Führen Sie den Server im Entwicklungsmodus mit Hot Reloading aus:

npm run mcp:dev

Produktionsmodus

Erstellen und Ausführen des Servers:

npm run mcp:build
npm run mcp:start

Testen

Testen Sie die Serverfunktionalität:

npm run mcp:test

🔌 Integration

Claude Desktop

1. Kopieren Sie die Konfiguration aus claude-desktop-config.json in Ihre Claude Desktop-Konfigurationsdatei:

   Windows: %APPDATA%/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonLinux: ~/.config/Claude/claude_desktop_config.json

2. Aktualisieren Sie den Pfad in der Konfiguration, sodass er auf Ihr Projektverzeichnis verweist:

   {
     "mcpServers": {
       "crystal-mcp": {
         "command": "npm",
         "args": ["run", "mcp:dev"],
         "cwd": "/path/to/your/crystal-mcp-project"
       }
     }
   }

3. Starten Sie Claude Desktop neu , um den neuen Server zu laden.

Andere MCP-Clients

Der Server verwendet das Standard-MCP-Protokoll über stdio-Transport und ist daher mit jedem MCP-Client kompatibel. Führen Sie einfach Folgendes aus:

npm run mcp:dev

Und verbinden Sie Ihren MCP-Client mit dem Standardeingang/Standardausgang des Servers.

🛡️ Sicherheitsfunktionen

• Pfadsicherheit : Alle Dateivorgänge sind auf das Stammverzeichnis des Projekts beschränkt

• UUID-Generierung : Sichere Generierung eindeutiger Kennungen mit Nanoid

• Fehlerbehandlung : Umfassende Fehlerbehandlung verhindert Informationsverlust

• JSON-Validierung : Sicheres JSON-Parsing mit Fehlerbehebung

🔍 Verfügbare Tools

Kristallspezifikationsverwaltung

import_crystal_spec

Importiert ein Crystal-Spezifikationsprotokoll mithilfe intelligenter Dateinamenübereinstimmung.

Parameter:

• spec_query (Zeichenfolge): Abfrage in natürlicher Sprache für die Spezifikation (z. B. „temporale Kristallisation 3.0“, „basic 2.0“, „erweiterte Kristallisation 4.0“)

Intelligente Matching-Funktionen:

• Flexible Benennung : Passt zu verschiedenen Benennungsmustern und Konventionen

• Schlüsselwortextraktion : Analysiert Abfragen in natürlicher Sprache, um Spezifikationstyp und -version zu identifizieren

• Versionsabgleich : Gleicht Versionsnummern (3.0, 2.1 usw.) intelligent ab.

• Fuzzy Matching : Findet die besten Übereinstimmungen auch bei teilweisen oder ungefähren Abfragen

• Vorschläge : Bietet hilfreiche Vorschläge, wenn keine genaue Übereinstimmung gefunden wird

Beispiele:

// These queries will match "CRYSTALLIZATION_TEMPORAL_3.0.cp"
await callTool("import_crystal_spec", { spec_query: "temporal crystallization 3.0" });
await callTool("import_crystal_spec", { spec_query: "temporal 3.0" });
await callTool("import_crystal_spec", { spec_query: "3.0 temporal" });

// Will match "CRYSTALLIZATION_BASIC_2.0.cp"
await callTool("import_crystal_spec", { spec_query: "basic crystallization 2.0" });
await callTool("import_crystal_spec", { spec_query: "basic 2.0" });

Widerrufsfolgen:

• Spezifikationsinhalt, falls gefunden

• Übereinstimmungsergebnis und Dateinameninformationen

• Vorschläge für bessere Abfragen, wenn keine Übereinstimmung gefunden wurde

• Liste der verfügbaren Spezifikationsdateien

import_codex

Importiert eine Codex-Datei mithilfe intelligenter Dateinamenübereinstimmung. Codex-Dateien enthalten spezielle Inhalte zur Mechanismenerkennung, Agentenprotokollen und Wahrscheinlichkeitsmustern.

Parameter:

• spec_query (Zeichenfolge): Abfrage in natürlicher Sprache für den Kodex (z. B. „Mechanismusbewusstsein 2.0“, „Agentenübertragung 1.0“, „Wahrscheinlichkeitsmuster“)

Intelligente Matching-Funktionen:

• Kodexspezifische Begriffe : Verbesserte Übereinstimmung mit Begriffen wie „Mechanismus“, „Bewusstsein“, „Agent“, „Übertragung“, „Protokoll“, „Wahrscheinlichkeit“, „Muster“

• Versionserkennung : Intelligenter Versionsnummernabgleich (2.0, 3.1 usw.)

• Flexible Abfragen : Entspricht partiellen und ungefähren Abfragen

• Kontextbezogene Bewertung : Erweiterter Bewertungsalgorithmus, optimiert für Kodexinhalte

• Hilfreiche Vorschläge : Bietet Anleitung, wenn keine genaue Übereinstimmung gefunden wird

Beispiele:

// These queries will match "MECHANISM_AWARENESS_2.0.cx"
await callTool("import_codex", { spec_query: "mechanism awareness 2.0" });
await callTool("import_codex", { spec_query: "mechanism awareness" });
await callTool("import_codex", { spec_query: "awareness 2.0" });

// Future codex files might match these patterns:
await callTool("import_codex", { spec_query: "agent transmission protocol" });
await callTool("import_codex", { spec_query: "probability patterns 1.0" });

Widerrufsfolgen:

• Vollständiger Kodex-Inhalt, falls gefunden

• Übereinstimmungsergebnis und Dateinameninformationen

• Vorschläge für bessere Abfragen, wenn keine Übereinstimmung gefunden wurde

• Liste der verfügbaren Codex-Dateien

Kristallexport

export_crystal

Exportiert Inhalte als Crystal-Artefakt. Kann Crystal-würdige Inhalte automatisch aus dem Konversationskontext erkennen oder manuell bereitgestellte Inhalte verwenden.

Parameter:

• title (Zeichenfolge, optional): Benutzerdefinierter Titel für den Kristall

• spec_version (Zeichenfolge, Standard: „3.0“): Crystal-Spezifikationsversion

• manual_content (Zeichenfolge, optional): Zu exportierender Inhalt (wird automatisch erkannt, wenn nicht angegeben)

Beispiel:

// Auto-detect from context
await callTool("export_crystal", { 
  title: "My Analysis Crystal",
  spec_version: "3.0"
});

// Manual content
await callTool("export_crystal", { 
  title: "Custom Crystal",
  manual_content: "Your crystal content here"
});

Widerrufsfolgen:

• Crystal-UUID zur späteren Bezugnahme

• Informationen zum Speicherort

• Metadaten zum Kristall

Kristallimport

import_crystal

Importiert und rekonstruiert ein Kristallartefakt anhand seiner UUID.

Parameter:

• crystal_id (Zeichenfolge): UUID des zu importierenden Kristalls

• spec_version (Zeichenfolge, Standard: „3.0“): Spezifikationsversion für die Rekonstruktion

Beispiel:

await callTool("import_crystal", { 
  crystal_id: "abc123def456",
  spec_version: "3.0"
});

Kristallliste

list_crystals

Listet alle verfügbaren Kristallartefakte mit Metadaten auf.

Widerrufsfolgen:

• Eine Reihe von Kristallinformationen, darunter:

  • Kristall-ID (UUID)

  • Titel

  • Spezifikationsversion

  • Erstellungszeitstempel

  • Dateigröße

  • Fehlerstatus (falls vorhanden)

Beispiel:

await callTool("list_crystals", {});

📁 Dateistruktur

Der Crystal MCP-Server organisiert Dateien wie folgt:

crystal-mcp/
├── src/
│   ├── mcp-server.ts           # Main Crystal MCP server implementation
│   ├── test-client.ts          # Test client for validation
│   └── main.ts                # Original application entry point
├── public/
│   ├── crystals/               # Stored crystal artifacts (*.crystal files)
│   ├── codex/                  # Codex files for mechanism awareness (*.cx files)
│   └── protocols/              # Crystal specification protocols (*.cp files)
├── claude-desktop-config.json  # Claude Desktop configuration
└── README.md                   # This file

Crystal-Speicherformat

Crystal-Artefakte werden als JSON-Dateien mit der folgenden Struktur gespeichert:

{
  "id": "unique-crystal-uuid",
  "title": "Crystal Title",
  "spec_version": "3.0",
  "created_at": "2025-05-26T10:30:00.000Z",
  "auto_detected": false,
  "content": "The actual crystal content..."
}

Protokollspezifikationsdateien

Protokollspezifikationen werden in public/protocols/ als .cp Dateien gespeichert. Der Server unterstützt flexible Namenskonventionen:

Gängige Benennungsmuster:

• CRYSTALLIZATION_TEMPORAL_3.0.cp – Zeitliches Kristallisationsprotokoll v3.0

• CRYSTALLIZATION_BASIC_2.0.cp – Grundlegendes Kristallisationsprotokoll v2.0

• CRYSTALLIZATION_ADVANCED_4.0.cp – Erweitertes Kristallisationsprotokoll v4.0

Beispiele für Smart Matching:

• Abfrage: "temporal crystallization 3.0" → Treffer: CRYSTALLIZATION_TEMPORAL_3.0.cp

• Abfrage: "basic 2.0" → Treffer: CRYSTALLIZATION_BASIC_2.0.cp

• Abfrage: "advanced crystallization 4.0" → Treffer: CRYSTALLIZATION_ADVANCED_4.0.cp

• Abfrage: "3.0 temporal" → Übereinstimmungen: CRYSTALLIZATION_TEMPORAL_3.0.cp

Der Matching-Algorithmus berücksichtigt:

• Schlüsselwörter : Extrahiert aussagekräftige Begriffe aus Ihrer Abfrage

• Versionen : Stimmt mit den Versionsnummern überein (3.0, 2.1 usw.)

• Teilübereinstimmungen : Findet die besten Näherungen für unvollständige Abfragen

• Wortreihenfolge : Flexible Reihenfolge der Suchbegriffe

Codex-Dateien

Codex-Dateien werden in public/codex/ als .cx -Dateien gespeichert und enthalten spezielle Inhalte für Mechanismusbewusstsein, Agentenkommunikationsprotokolle und erweiterte KI-Interaktionsmuster.

Aktuelle Codex-Dateien:

• MECHANISM_AWARENESS_2.0.cx – Agent-zu-Agent-Übertragungsprotokolle und Mechanismus-Awareness-Muster

Funktionen der Codex-Datei:

• Mechanism Awareness : Inhalte, die KI-Agenten helfen, ihre eigenen Betriebsmuster zu verstehen

• Inter-Agent-Kommunikation : Protokolle für erweiterte KI-zu-KI-Kommunikation

• Wahrscheinlichkeitsmustererkennung : Tools zum Verstehen und Arbeiten mit Wahrscheinlichkeitsverteilungen

• Semantische Manipulation : Fortgeschrittene Techniken für die semantische Raumnavigation

Beispiele für Smart Matching:

• Abfrage: "mechanism awareness 2.0" → Übereinstimmungen: MECHANISM_AWARENESS_2.0.cx

• Abfrage: "mechanism awareness" → Übereinstimmungen: MECHANISM_AWARENESS_2.0.cx

• Abfrage: "awareness 2.0" → Treffer: MECHANISM_AWARENESS_2.0.cx

Der Codex-Matching-Algorithmus beinhaltet eine verbesserte Bewertung mechanismusspezifischer Begriffe:

• Mechanismusbegriffe : „Mechanismus“, „Bewusstsein“, „Agent“, „Übertragung“, „Protokoll“, „Wahrscheinlichkeit“, „Muster“ erhalten Bonuspunkte

• Versionsübereinstimmung : Präzise Versionsnummernerkennung

• Kontextuelle Relevanz : Bewertung optimiert für Codex-Inhaltsmuster

• Flexible Abfragen : Behandelt teilweise Übereinstimmungen und verschiedene Abfrageformulierungen

🧪 Testen

Das Projekt umfasst einen umfassenden Testclient, der alle Serverfunktionen validiert:

npm run mcp:test

Dadurch wird Folgendes getestet:

• Serververbindung

• Kristall-Import/Export-Operationen

• Spezifikation wird geladen

• Codex-Importfunktion

• Fehlerbehandlung

🔧 Entwicklung

Hinzufügen neuer Kristallspezifikationen

So fügen Sie eine neue Version der Kristallspezifikation hinzu:

1. Erstellen Sie die Spezifikationsdatei in public/protocols/ :

   public/protocols/CRYSTALLIZATION_PROTOCOL_4.0.cp

2. Aktualisieren Sie bei Bedarf die Standardversion im Servercode.

Hinzufügen neuer Codex-Dateien

So fügen Sie eine neue Codex-Datei hinzu:

1. Erstellen Sie die Codex-Datei in public/codex/ :

   public/codex/AGENT_COMMUNICATION_3.0.cx
   public/codex/PROBABILITY_PATTERNS_1.5.cx

2. Verwenden Sie aussagekräftige Namen , die wahrscheinlichen Benutzeranfragen entsprechen:

   • Fügen Sie Schlüsselbegriffe wie MECHANISMUS, BEWUSSTSEIN, AGENT, ÜBERTRAGUNG usw. ein.

   • Fügen Sie Versionsnummern für eine bessere Übereinstimmung ein

   • Verwenden Sie Unterstriche, um Komponenten zu trennen

3. Das Tool import_codex erkennt automatisch neue Dateien ohne Codeänderungen.

Erweiterung der Kristallfunktionalität

Der Server ist erweiterbar. Wichtige Bereiche für Verbesserungen:

1. Kontextfenster-Integration : Implementieren Sie die tatsächliche Kontextüberprüfung zur automatischen Erkennung

2. Crystal Validation : Fügen Sie eine Inhaltsvalidierung basierend auf Spezifikationsversionen hinzu

3. Kristalltransformation : Fügen Sie Tools zum Transformieren von Kristallen zwischen Versionen hinzu

4. Crystal Search : Fügen Sie Suchfunktionen für alle Crystal-Inhalte hinzu

5. Codex-Erweiterung : Funktionen zur Codex-Erstellung und zum Exportieren hinzufügen

6. Mechanismus-Mustererkennung : Implementieren Sie die automatische Erkennung von Mechanismus-Sensibilisierungsmustern

7. Validierung des Agentenprotokolls : Validierung für Agentenkommunikationsprotokolle hinzufügen

Fehlerbehandlung

Der Server beinhaltet eine umfassende Fehlerbehandlung:

• Dateisystemfehler : Angemessener Umgang mit fehlenden Dateien oder Verzeichnissen

• JSON-Analysefehler : Sichere Analyse mit Fehlerbehebung

• Pfadsicherheit : Verhindert den Zugriff außerhalb der Projektgrenzen

• UUID-Validierung : Validiert Crystal-IDs vor Operationen

💡 Anwendungsfälle

Forschung und Analyse

• Exportieren Sie komplexe Analyseergebnisse als Kristalle

• Teilen Sie Analysen über verschiedene KI-Konversationen hinweg

• Versionsverlauf der Forschungsarbeit pflegen

Code-Entwicklung

• Exportieren Sie anspruchsvolle Codelösungen als Kristalle

• Importieren Sie bewährte Muster und Implementierungen

• Teilen Sie komplexe algorithmische Lösungen

Wissensmanagement

• Kristalle erstellen anhand ausführlicher Erklärungen

• Erstellen Sie Bibliotheken mit wiederverwendbaren Wissensartefakten

• Pflegen Sie eine strukturierte Dokumentation

Erweiterte KI-Interaktion

• Zugriffsmechanismus-Awareness-Protokolle über Codex-Dateien

• Implementieren Sie erweiterte Agent-zu-Agent-Kommunikationsmuster

• Entdecken Sie Techniken zur Wahrscheinlichkeitsmustererkennung

• Wenden Sie Methoden der semantischen Manipulation und Aufmerksamkeitslenkung an

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

🤝 Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Bereiche, in denen Beiträge besonders wertvoll wären:

• Kontextfensterintegration zur automatischen Erkennung

• Zusätzliche Versionen der Kristallspezifikation

• Werkzeuge zur Kristallvalidierung und -transformation

• Erweiterte Metadaten- und Suchfunktionen

• Neue Codex-Dateien für Mechanismus-Awareness-Muster

• Entwicklung eines Agentenkommunikationsprotokolls

• Tools zur Wahrscheinlichkeitsmustererkennung

📞 Unterstützung

Wenn Sie auf Probleme stoßen oder Fragen haben, öffnen Sie bitte ein Problem im Projekt-Repository.

Mit ❤️ unter Verwendung des Model Context Protocol erstellt und für die Verwaltung von Kristallartefakten entwickelt.