localutils

Local Utilities MCP Server exposes a set of handy system utilities via the MCP protocol so Cursor and other MCP-compatible clients can query time, hostname, public IP, directory listings, Node.js version, port usage, and a lightweight 'think' tool for recording development thoughts. It registers as an MCP server under the name localutils and is designed to be invoked through npx or a global installation, making it easy to run without a full setup. The tools are grouped into practical commands that return structured data, allowing clients to present results in a consistent format.

To use it, start the server via npx or install it globally, then configure your MCP client (e.g., Cursor) to connect to the localutils server. You can invoke individual tools like get_time_and_date, get_hostname, get_public_ip, list_directory, get_node_version, check_port, think, get_thoughts, clear_thoughts, and get_thought_stats to retrieve data in a predictable schema suitable for dashboards and automation scripts.

Prerequisites:

• Node.js and npm or pnpm installed on your machine
• Access to install global npm/pnpm packages or run via npx

Installation options:

1. Global installation (recommended for local development):

pnpm add -g localutils-mcp-server

2. Using with npx (no installation required):

npx localutils-mcp-server

3) If you prefer Yarn, ensure you have a compatible setup to run npx commands for this package.

Note: The repository itself may include a prebuilt bundle for quick use via npx, as described in the repository README.

Tips and common issues:

• The server exposes multiple MCP tools; refer to the README for exact tool names and parameters.
• When using Cursor, configure the MCP server with the following example: { "mcpServers": { "localutils": { "command": "npx", "args": ["github:arjshiv/localutils-mcp-server"] } } }
• If you run into port or environment issues, ensure your local firewall allows required connections and that Node.js is accessible in your PATH.
• The Think tool stores thoughts during development sessions; consider clearing thoughts periodically with the provided commands to manage storage.
• The MCP Inspector can be started with pnpm run inspector if you want a UI for testing the endpoints.