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)