NHN Server MCP

Ein MCP-Server (Model Context Protocol), der eine Verbindung zu Servern über ein SSH-Gateway herstellt und Befehle ausführt.

Funktionen

• Serverzugriff über SSH-Gateway

• Unterstützung für Kerberos-Authentifizierung (kinit)

• Bestätigung der Befehlsausführung über native macOS-Dialoge

• Automatische Genehmigung identischer Befehle mit der Option "Immer erlauben"

• Abruf von Serverinformationen (ermöglicht der KI das Prüfen von Log-Pfaden etc.)

• SCP-Datei-Upload/-Download über das Gateway

• Schutz vor Prozess-Hangs durch Timeouts für Remote-Befehle

• Dynamisches Neuladen der Konfiguration

Installation

npm install
npm run build

Konfiguration

1. config.json erstellen

{
  "gatewayConnection": "user@gateway.example.com:22",
  "gatewayPassword": "your-password",
  "kinitPassword": "your-kerberos-password",
  "allowedHosts": ["server1", "server2"],
  "confirmDialog": true,
  "serverInfo": {
    "서버에 대한 user 정보 필수": "exec 할때 user 를 같이 보냅니다.",
    "나머지는": "원하는 내용으로",
    "ex - logPaths": {
      "app": "/var/log/app.log",
      "nginx": "/var/log/nginx/access.log"
    }
  }
}

2. Client-Konfiguration

Claude Code (CLI)

Registrierung über CLI-Befehl:

# 프로젝트 단위 (해당 프로젝트에서만 사용)
claude mcp add --scope project nhn-server -e CONFIG_FILE=/path/to/config.json -e DEBUG=false -- node /path/to/nhn-server-mcp/dist/index.js

# 글로벌 (모든 프로젝트에서 사용)
claude mcp add --scope user nhn-server -e CONFIG_FILE=/path/to/config.json -e DEBUG=false -- node /path/to/nhn-server-mcp/dist/index.js

Alternativ können Sie die Konfigurationsdatei direkt bearbeiten.

Projektbasiert — Erstellen Sie eine .mcp.json im Projektstammverzeichnis:

{
  "mcpServers": {
    "nhn-server": {
      "command": "node",
      "args": ["/path/to/nhn-server-mcp/dist/index.js"],
      "env": {
        "CONFIG_FILE": "/path/to/config.json",
        "DEBUG": "false"
      }
    }
  }
}

Global — Hinzufügen zu ~/.claude.json:

{
  "mcpServers": {
    "nhn-server": {
      "command": "node",
      "args": ["/path/to/nhn-server-mcp/dist/index.js"],
      "env": {
        "CONFIG_FILE": "/path/to/config.json",
        "DEBUG": "false"
      }
    }
  }
}

.mcp.json — Wird nur in diesem Projekt verwendet. Kann in Git committet und mit Teammitgliedern geteilt werden (Vorsicht: Der Pfad zu config.json kann individuell variieren).

~/.claude.json — Wird in allen Projekten verwendet. Für persönliche Umgebungseinstellungen.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nhn-server": {
      "command": "node",
      "args": ["/path/to/nhn-server-mcp/dist/index.js"],
      "env": {
        "CONFIG_FILE": "/path/to/config.json",
        "DEBUG": "false"
      }
    }
  }
}

Konfigurationsoptionen

Umgebungsvariablen

MCP-Tools

exec

Führt einen Befehl auf dem Server aus.

{
  "host": "server-hostname",
  "user": "appuser",
  "command": "tail -100 /var/log/app.log"
}

Wenn confirmDialog aktiviert ist, wird ein nativer macOS-Dialog angezeigt:

• Abbrechen: Befehl nicht ausführen

• Bestätigen: Nur dieses Mal ausführen

• Immer erlauben: Ausführen + zukünftige identische Befehle ohne Bestätigung ausführen (wird beim Beenden der Sitzung zurückgesetzt)

get_config

Ruft Server-Konfigurationsinformationen ab (erlaubte Hosts, Serverinformationen).

reload_config

Lädt die Konfigurationsdatei neu.

disconnect_server

Beendet die Gateway-Verbindung.

connection_status

Überprüft den aktuellen Verbindungsstatus.

scp_upload

Lädt Dateiinhalt auf den Server hoch (SCP über Gateway).

{
  "host": "server-hostname",
  "user": "appuser",
  "remotePath": "/path/to/remote/file.txt",
  "content": "파일 내용"
}

scp_download

Lädt Dateien vom Server herunter (SCP über Gateway).

{
  "host": "server-hostname",
  "user": "appuser",
  "remotePath": "/path/to/remote/file.txt",
  "localPath": "/path/to/local/file.txt"
}

• Wenn localPath angegeben ist, wird die Datei lokal gespeichert

• Wenn localPath nicht angegeben ist, wird nur der Dateiinhalt zurückgegeben

Sicherheit

• Da config.json sensible Informationen (Passwörter) enthält, sollte sie nicht in Git committet werden

• confirmDialog erfordert eine Benutzerbestätigung vor der Befehlsausführung

• allowedHosts schränkt die zugänglichen Server ein

• Automatische Trennung der Verbindung nach 5 Minuten Inaktivität

• Automatische Bereinigung der Sitzung auch bei Ausnahmen

Lizenz

MIT