Local Utilities MCP Server
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-serverUso con npx
También puedes ejecutar el servidor directamente usando npx sin instalarlo globalmente:
npx localutils-mcp-serverUso
Iniciando el servidor
Si se instala globalmente:
localutils-mcpCon npx:
npx localutils-mcp-serverUso 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 inspectorEsto 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 buildEjecutando en modo de desarrollo
pnpm run devPruebas
pnpm testFlujo 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 installEsto 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 toolscheck_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
Scored across 10 tools
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.
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.
10 tools is a reasonable number for a local utilities server, covering both system information and a thought management module without overloading the surface.
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
Related MCP Connectors
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Read-only developer, date, finance, and text utilities. Authless remote MCP server by Clean.tools.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.311MIT
- AlicenseNot gradedqualityDmaintenanceA 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
- FlicenseAqualityDmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceLightweight MCP server providing system time tools (current time, date, datetime, time components, unix timestamp) for LLM applications.1MIT