Local Utilities MCP Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Supports Linux systems for port checking functionality, allowing users to identify processes running on specific ports.
Supports macOS systems for port checking functionality, allowing users to identify processes running on specific ports.
Provides access to Node.js version information, allowing clients to retrieve details about the Node.js environment running on the local system.
Local Utilities MCP Server
A Model Context Protocol (MCP) server that provides access to various local system utilities. This server can be used with Cursor and other MCP-compatible clients to provide quick access to system information.
Features
The server provides the following utilities:
- Time and Date: Get the current local time and date, including day of the week, in various formats
- Hostname: Get the system's hostname
- Public IP: Get the machine's public IP address
- Directory Listing: List the contents of a specified directory
- Node.js Version: Get the currently running Node.js version
- Port Checker: Check what process is running on a specific port
- Think Tool: Record, retrieve, and analyze thoughts during development sessions
Installation
Global Installation
Using with npx
You can also run the server directly using npx without installing it globally:
Usage
Starting the Server
If installed globally:
With npx:
Using with Cursor
The server can be used with Cursor by configuring it as an MCP server in Cursor's settings.
- Open Cursor settings
- Navigate to the MCP section
- Add a new MCP server with the following configuration:Copy
Using the MCP Inspector
You can test the server using the MCP Inspector:
This will start the MCP Inspector at http://localhost:5173.
Available Tools
get_time_and_date
Returns the current local time and date in various formats, including:
- Local time
- Local date
- Day of the week
- ISO 8601 format
- Unix timestamp
get_hostname
Returns the hostname of the machine running the MCP server.
get_public_ip
Returns the public IP address of the machine running the MCP server.
list_directory
Lists the contents of a specified directory.
Parameters:
path(string, required): Directory path to list
get_node_version
Returns the Node.js version information of the environment running the MCP server.
check_port
Checks what process is running on a specific port.
Parameters:
port(number or string, required): Port number to check (1-65535). String values will be automatically converted to numbers.
Example Response (macOS/Linux):
think
Records a new thought with timestamp.
Parameters:
thought(string, required): The thought content to record
Example Response:
get_thoughts
Retrieves all recorded thoughts.
Example Response:
clear_thoughts
Clears all recorded thoughts.
Example Response:
get_thought_stats
Returns statistics about recorded thoughts.
Example Response:
Development
Building
Running in Development Mode
Testing
Git Workflow
This repository includes a pre-commit hook that automatically builds the server before each commit. This ensures that the build files are always up-to-date in the repository.
The build folder is included in the git repository to make it easier to use the package with npx without having to build it first.
To set up the pre-commit hook after cloning the repository:
This will install dependencies and set up the pre-commit hook via Husky.
License
MIT
This server cannot be installed
Provides quick access to local system utilities including time/date, hostname, public IP, directory listings, Node.js version, and port usage through an MCP server interface compatible with Cursor and other MCP clients.