Nexus-MCP

Ein umfassendes Model Context Protocol Toolkit für KI-Assistenten

Verwandeln Sie jeden KI-Assistenten in einen autonomen Agenten, der in der Lage ist, reale Aufgaben auszuführen.

Dokumentation • Erste Schritte • Roadmap • Architektur

🎯 Überblick

Nexus-MCP ist ein leistungsstarker Model Context Protocol (MCP) Server, der mit TypeScript/Node.js entwickelt wurde und KI-Modellen universelle Werkzeuge bietet für:

• 📁 Dateisystemoperationen - Dateien lesen, schreiben, suchen und überwachen

• 🌐 HTTP/Web-Anfragen - Daten abrufen, Websites scrapen, APIs aufrufen

• 🔄 Git-Workflows - Repositories klonen, committen, verzweigen und verwalten

• 🗄️ Datenbankabfragen - SQL- und NoSQL-Datenbanken abfragen

• 💻 Systembefehle - Shell-Befehle ausführen und Prozesse verwalten

• 🤖 KI-Integration - Mit LLMs chatten, Embeddings erstellen, Text verarbeiten

• 🔧 Dienstprogramme - JSON/YAML-Parsing, Komprimierung, Verschlüsselung und mehr

🚀 Schnellstart

Installation

npm install -g @nexus-mcp/server

Konfiguration

# Copy example environment file
cp .env.example .env

# Edit with your settings
nano .env

Ausführen

nexus-mcp

Integration mit Claude Code

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "node",
      "args": ["/path/to/nexus-mcp/dist/index.js"]
    }
  }
}

📦 Funktionen

Dateisystem-Tools

• nexus_read_file - Dateien mit Encoding-Unterstützung lesen

• nexus_write_file - Dateien schreiben/erstellen

• nexus_list_directory - Verzeichnisinhalt auflisten

• nexus_search_files - Dateien nach Muster suchen

• nexus_search_content - Inhalt innerhalb von Dateien suchen

• nexus_watch_directory - Verzeichnisänderungen überwachen

HTTP-Tools

• nexus_http_get - HTTP GET-Anfragen

• nexus_http_post - HTTP POST-Anfragen

• nexus_fetch_url - Webinhalte abrufen und parsen

• nexus_parse_html - HTML mit Cheerio parsen

• nexus_call_api - Generische API-Aufrufe

Git-Tools

• nexus_git_clone - Repositories klonen

• nexus_git_commit - Commits erstellen

• nexus_git_push - Auf Remote pushen

• nexus_git_pr_create - Pull Requests erstellen

• Integration mit GitHub, GitLab, Bitbucket

Datenbank-Tools

• nexus_db_query - SQL-Abfragen ausführen

• nexus_db_list_tables - Datenbanktabellen auflisten

• nexus_db_describe_table - Tabellenschema beschreiben

• Unterstützung für PostgreSQL, MySQL, SQLite, SQL Server, MongoDB

System-Tools

• nexus_exec_command - Shell-Befehle ausführen

• nexus_system_info - Systeminformationen abrufen

• nexus_process_list - Laufende Prozesse auflisten

• nexus_service_start/stop - Dienste verwalten

KI-Tools

• nexus_llm_chat - Mit LLMs chatten (Anthropic, OpenAI)

• nexus_embedding_create - Text-Embeddings erstellen

• nexus_text_summarize - Text zusammenfassen

• nexus_code_generate - Code generieren

Dienstprogramm-Tools

• nexus_json_parse/stringify - JSON-Manipulation

• nexus_yaml_parse/stringify - YAML-Manipulation

• nexus_zip_create/extract - ZIP-Komprimierung

• nexus_encrypt/decrypt - Verschlüsselung/Entschlüsselung

🏗️ Architektur

┌─────────────────────────────────────────┐
│         Claude / LLM Client              │
└──────────────┬──────────────────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────────────────┐
│           Nexus-MCP Server               │
│  ┌───────────────────────────────────┐  │
│  │      MCP Server Core             │  │
│  └───────────────────────────────────┘  │
│         ┌───────┴───────┐                │
│         │               │                │
│    ┌────▼────┐    ┌────▼────┐           │
│    │ Filesys │    │   HTTP  │           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │   Git   │    │ Database│           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │  System │    │    AI   │           │
│    └─────────┘    └─────────┘           │
└─────────────────────────────────────────┘

Für eine detaillierte Architektur siehe docs/architecture.md

🏛️ Produktionsreife Qualität

Nexus-MCP wurde mit dem Fokus auf architektonische Exzellenz entwickelt, konzipiert für den produktiven Einsatz und die Akzeptanz in der Community. Wir folgen strengen Prinzipien:

• ✅ Typsicherheit: TypeScript Strict Mode + Zod-Validierung

• ✅ Fehlerbehandlung: Strukturierte, umsetzbare Fehlermeldungen

• ✅ Leistung: Asynchrone Operationen, Caching, Streaming

• ✅ Sicherheit: Eingabevalidierung, Bereinigung, Audit-Logs

• ✅ Beobachtbarkeit: Strukturiertes Logging, Metriken, Tracing

• ✅ Testbarkeit: 80%+ Abdeckung, Dependency Injection

• ✅ Dokumentation: JSDoc, Beispiele, umfassende Anleitungen

• ✅ Entwicklererfahrung: Klare Fehler, IDE-Unterstützung, schnelles Feedback

Siehe Architektonische Prinzipien für vollständige Details.

📚 Dokumentation

• Erste-Schritte-Anleitung - Schnellstart und grundlegende Verwendung

• Architektur-Dokumentation - Systemarchitektur und Design

• Architektonische Prinzipien - Designprinzipien und Best Practices

• API-Referenz - Vollständige API-Dokumentation

• Tools-Referenz - Detaillierte Tool-Dokumentation

• Roadmap - Entwicklungs-Roadmap und Fortschritt

🛠️ Entwicklung

# Clone repository
git clone https://github.com/your-org/Nexus-MCP.git
cd Nexus-MCP

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Lint code
npm run lint

📊 Projektstatus

• Aktuelle Version: 1.0.0-alpha

• Entwicklungsstatus: Planung & Design

• Kernfortschritt: 0%

• Ziel-Tools: 50+

• Testabdeckungsziel: 80%+

Siehe ROADMAP.md für detaillierten Fortschritt.

🤝 Mitwirken

Beiträge sind willkommen! Bitte lesen Sie unsere Richtlinien für Mitwirkende, bevor Sie PRs einreichen.

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Branch (git checkout -b feature/amazing-feature)

3. Committen Sie Ihre Änderungen (git commit -m 'Add amazing feature')

4. Pushen Sie auf den Branch (git push origin feature/amazing-feature)

5. Öffnen Sie einen Pull Request

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE Datei für Details.

🙏 Danksagungen

• Model Context Protocol

• Anthropic Claude

• MCP SDK TypeScript

📞 Support

• 📖 Dokumentation

• 🐛 Issue Tracker

• 💬 Discord-Community

• ✉️ E-Mail: support@nexus-mcp.dev

Mit ❤️ entwickelt vom Nexus-Team