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

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.

Abrir la configuración del cursor
Navegar a la sección MCP
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)

Local Utilities MCP Server

Integrations

Servidor MCP de utilidades locales

Características

Instalación

Instalación global

Uso con npx

Uso

Iniciando el servidor

Uso con cursor

Uso del inspector MCP

Herramientas disponibles

`get_time_and_date`

`get_hostname`

`get_public_ip`

`list_directory`

`get_node_version`

`check_port`

`think`

`get_thoughts`

`clear_thoughts`

`get_thought_stats`

Desarrollo

Edificio

Ejecutando en modo de desarrollo

Pruebas

Flujo de trabajo de Git

Licencia

Related Resources