Lokale Dienstprogramme MCP-Server

Ein Model Context Protocol (MCP)-Server, der Zugriff auf verschiedene lokale Systemdienstprogramme ermöglicht. Dieser Server kann mit Cursor und anderen MCP-kompatiblen Clients verwendet werden, um schnellen Zugriff auf Systeminformationen zu ermöglichen.

Merkmale

Der Server stellt die folgenden Dienstprogramme bereit:

• Uhrzeit und Datum : Erhalten Sie die aktuelle Ortszeit und das Datum, einschließlich des Wochentags, in verschiedenen Formaten

• Hostname : Holen Sie sich den Hostnamen des Systems

• Öffentliche IP : Holen Sie sich die öffentliche IP-Adresse des Computers

• Verzeichnisliste : Listet den Inhalt eines angegebenen Verzeichnisses auf

• Node.js-Version : Holen Sie sich die aktuell ausgeführte Node.js-Version

• Port Checker : Überprüfen Sie, welcher Prozess auf einem bestimmten Port ausgeführt wird

• Denkwerkzeug : Aufzeichnen, Abrufen und Analysieren von Gedanken während Entwicklungssitzungen

Related MCP server: MCP TS Toolkit

Installation

Globale Installation

pnpm add -g localutils-mcp-server

Verwendung mit npx

Sie können den Server auch direkt mit npx ausführen, ohne es global zu installieren:

npx localutils-mcp-server

Verwendung

Starten des Servers

Bei globaler Installation:

localutils-mcp

Mit npx:

npx localutils-mcp-server

Verwendung mit Cursor

Der Server kann mit Cursor verwendet werden, indem er in den Cursor-Einstellungen als MCP-Server konfiguriert wird.

1. Cursoreinstellungen öffnen

2. Navigieren Sie zum MCP-Bereich

3. Fügen Sie einen neuen MCP-Server mit der folgenden Konfiguration hinzu:

   {
    "name": "localutils",
    "command": "npx",
    "args": ["localutils-mcp-server"]
   }

Verwenden des MCP-Inspektors

Sie können den Server mit dem MCP Inspector testen:

pnpm run inspector

Dadurch wird der MCP Inspector unter http://localhost:5173 gestartet.

Verfügbare Tools

get_time_and_date

Gibt die aktuelle Ortszeit und das Datum in verschiedenen Formaten zurück, darunter:

• Ortszeit

• Lokales Datum

• Wochentag

• ISO 8601-Format

• Unix-Zeitstempel

get_hostname

Gibt den Hostnamen des Computers zurück, auf dem der MCP-Server ausgeführt wird.

get_public_ip

Gibt die öffentliche IP-Adresse des Computers zurück, auf dem der MCP-Server ausgeführt wird.

list_directory

Listet den Inhalt eines angegebenen Verzeichnisses auf.

Parameter:

• path (Zeichenfolge, erforderlich): Verzeichnispfad zur Liste

get_node_version

Gibt die Node.js-Versionsinformationen der Umgebung zurück, in der der MCP-Server ausgeführt wird.

check_port

Überprüft, welcher Prozess auf einem bestimmten Port ausgeführt wird.

Parameter:

• port (Zahl oder Zeichenfolge, erforderlich): Zu prüfende Portnummer (1-65535). Zeichenfolgenwerte werden automatisch in Zahlen umgewandelt.

Beispielantwort (macOS/Linux):

{
 "processes": [
 {
 "command": "node",
 "pid": "12345",
 "user": "username",
 "fd": "12u",
 "type": "IPv4",
 "device": "0x1234567890",
 "size": "0t0",
 "node": "TCP",
 "name": "*:3000 (LISTEN)"
 }
 ],
 "message": "Found 1 process(es) using port 3000"
}

think

Zeichnet einen neuen Gedanken mit Zeitstempel auf.

Parameter:

• thought (Zeichenfolge, erforderlich): Der aufzuzeichnende Gedankeninhalt

Beispielantwort:

{
 "success": true,
 "data": {
 "message": "Thought recorded successfully"
 }
}

get_thoughts

Ruft alle aufgezeichneten Gedanken ab.

Beispielantwort:

{
 "success": true,
 "data": {
 "thoughts": [
 {
 "timestamp": "2025-03-24T15:00:00.000Z",
 "content": "Need to update the documentation"
 }
 ]
 }
}

clear_thoughts

Löscht alle aufgezeichneten Gedanken.

Beispielantwort:

{
 "success": true,
 "data": {
 "message": "All thoughts cleared"
 }
}

get_thought_stats

Gibt Statistiken zu aufgezeichneten Gedanken zurück.

Beispielantwort:

{
 "success": true,
 "data": {
 "totalThoughts": 1,
 "averageLength": 28,
 "oldestThought": "2025-03-24T15:00:00.000Z",
 "newestThought": "2025-03-24T15:00:00.000Z"
 }
}

Entwicklung

Gebäude

pnpm run build

Ausführen im Entwicklungsmodus

pnpm run dev

Testen

pnpm test

Git-Workflow

Dieses Repository enthält einen Pre-Commit-Hook, der den Server vor jedem Commit automatisch erstellt. Dadurch wird sichergestellt, dass die Build-Dateien im Repository immer auf dem neuesten Stand sind.

Der Build-Ordner ist im Git-Repository enthalten, um die Verwendung des Pakets mit npx zu erleichtern, ohne es zuerst erstellen zu müssen.

So richten Sie den Pre-Commit-Hook nach dem Klonen des Repositorys ein:

pnpm install

Dadurch werden Abhängigkeiten installiert und der Pre-Commit-Hook über Husky eingerichtet.

Lizenz

MIT

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• check_portD
• clear_thoughtsA
• get_hostnameA
• get_node_versionA
• get_public_ipA
• get_thoughtsB
• get_thought_statsC
• get_time_and_dateA