Skip to main content
Glama
Local Utilities MCP Server

Local Utilities MCP Server

by arjshiv

Servidor MCP de utilidades locales

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a diversas utilidades del sistema local. Este servidor puede utilizarse con Cursor y otros clientes compatibles con MCP para proporcionar acceso rápido a la información del sistema.

Características

El servidor proporciona las siguientes utilidades:

  • Hora y fecha : obtenga la hora y fecha locales actuales, incluido el día de la semana, en varios formatos

  • Nombre de host : obtiene el nombre de host del sistema

  • IP pública : obtener la dirección IP pública de la máquina

  • Listado de directorios : enumera el contenido de un directorio específico

  • Versión de Node.js : obtenga la versión de Node.js que se está ejecutando actualmente

  • Comprobador de puertos : comprueba qué proceso se está ejecutando en un puerto específico

  • Think Tool : registre, recupere y analice pensamientos durante las sesiones de desarrollo

Related MCP server: Simple MCP Server

Instalación

Instalación global

pnpm add -g localutils-mcp-server

Uso con npx

También puedes ejecutar el servidor directamente usando npx sin instalarlo globalmente:

npx localutils-mcp-server

Uso

Iniciando el servidor

Si se instala globalmente:

localutils-mcp

Con npx:

npx localutils-mcp-server

Uso con cursor

El servidor se puede utilizar con Cursor configurándolo como servidor MCP en la configuración de Cursor.

  1. Abrir la configuración del cursor

  2. Navegar a la sección MCP

  3. Agregue un nuevo servidor MCP con la siguiente configuración:

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

Uso del inspector MCP

Puede probar el servidor utilizando el Inspector MCP:

pnpm run inspector

Esto iniciará el Inspector MCP en http://localhost:5173 .

Herramientas disponibles

get_time_and_date

Devuelve la fecha y hora local actual en varios formatos, incluidos:

  • Hora local

  • Fecha local

  • Día de la semana

  • Formato ISO 8601

  • Marca de tiempo de Unix

get_hostname

Devuelve el nombre de host de la máquina que ejecuta el servidor MCP.

get_public_ip

Devuelve la dirección IP pública de la máquina que ejecuta el servidor MCP.

list_directory

Enumera el contenido de un directorio especificado.

Parámetros:

  • path (cadena, obligatoria): Ruta del directorio a listar

get_node_version

Devuelve la información de la versión Node.js del entorno que ejecuta el servidor MCP.

check_port

Comprueba qué proceso se está ejecutando en un puerto específico.

Parámetros:

  • port (número o cadena, obligatorio): Número de puerto a verificar (1-65535). Los valores de cadena se convertirán automáticamente a números.

Ejemplo de respuesta (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

Registra un nuevo pensamiento con marca de tiempo.

Parámetros:

  • thought (cadena, obligatorio): El contenido del pensamiento a registrar

Ejemplo de respuesta:

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

get_thoughts

Recupera todos los pensamientos registrados.

Ejemplo de respuesta:

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

clear_thoughts

Borra todos los pensamientos registrados.

Ejemplo de respuesta:

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

get_thought_stats

Devuelve estadísticas sobre los pensamientos registrados.

Ejemplo de respuesta:

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

Desarrollo

Edificio

pnpm run build

Ejecutando en modo de desarrollo

pnpm run dev

Pruebas

pnpm test

Flujo de trabajo de Git

Este repositorio incluye un gancho de precommit que compila automáticamente el servidor antes de cada commit. Esto garantiza que los archivos de compilación estén siempre actualizados en el repositorio.

La carpeta de compilación está incluida en el repositorio git para facilitar el uso del paquete con npx sin tener que compilarlo primero.

Para configurar el gancho de pre-confirmación después de clonar el repositorio:

pnpm install

Esto instalará dependencias y configurará el gancho de pre-confirmación a través de Husky.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

10 tools
check_portD

Inputs: port (required).

clear_thoughtsA

Clear all recorded thoughts

get_hostnameA

Returns the hostname of the machine running the MCP server.

get_node_versionA

Returns the Node.js version information of the environment running the MCP server.

get_public_ipA

Returns the public IP address of the machine running the MCP server.

get_thoughtsB

Retrieve all recorded thoughts

get_thought_statsC

Get statistics about recorded thoughts

get_time_and_dateA

Returns the current time, date, day of week, and timestamp in various formats

list_directoryD

Inputs: path (required).

thinkD

Inputs: thought (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a distinct name and purpose, even though some lack descriptions. The 'get_*' tools clearly differentiate between hostname, node version, public IP, time/date, and thoughts, while 'list_directory', 'check_port', and the thought management tools are all distinct.

    Naming Consistency5/5

    All tool names follow a consistent lowercase_snake_case pattern, predominantly using verb_noun structure (e.g., 'get_hostname', 'list_directory', 'clear_thoughts'). The single verb 'think' is a minor deviation but still fits the pattern.

    Tool Count5/5

    10 tools is a reasonable number for a local utilities server, covering both system information and a thought management module without overloading the surface.

    Completeness3/5

    The thought management tools are complete, but the system utilities are sparse, lacking common operations like disk space, CPU usage, or process listing. This leaves notable gaps for a 'Local Utilities' server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A comprehensive MCP server with 30+ custom tools organized into categories: date/time operations, file management, system information, text processing, and web operations. Enables async communication with robust error handling and flexible CLI integration.
      31
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A self-contained, dependency-free MCP server that provides utility tools for time, date, mathematical calculations, and shell command execution. It supports remote connectivity through SSE and is designed for easy deployment via Docker.
      GPL 3.0
    • F
      license
      A
      quality
      D
      maintenance
      A general-purpose MCP server providing time-related utilities such as fetching current time, Unix timestamps, and formatting services. It supports both local stdio and remote SSE communication modes for versatile AI client integration.
      3
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Lightweight MCP server providing system time tools (current time, date, datetime, time components, unix timestamp) for LLM applications.
      1
      MIT