MCP Helper Tools

You are provisioning a Model Context Protocol (MCP) server that exposes a set of utilities for tasks like geolocation, network checks, cryptographic operations, and QR code generation. This server is designed to be consumed by MCP clients and AI agents to perform system utilities and data operations in a structured, standardized way.

How to use

Connect your MCP client to the toolkit server and invoke tools by name through the MCP interface. Use the toolkit to geolocate IPs, check connectivity to hosts, retrieve system information, compute cryptographic hashes, generate UUIDs, and create QR codes. Each operation is exposed as a named endpoint that you call from your MCP client, returning structured results that you can integrate into your automation, analyses, or decision logic.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

# Using npm (recommended)
npm install @cyanheads/toolkit-mcp-server

# Or install from source
git clone git@github.com:cyanheads/toolkit-mcp-server.git
cd toolkit-mcp-server
npm install
npm run build

Configuration

Configure your MCP client to load the toolkit server as an MCP endpoint. The following example shows how to register the toolkit MCP server in your client settings.

{
  "mcpServers": {
    "toolkit": {
      "command": "node",
      "args": ["node_modules/@cyanheads/toolkit-mcp-server/build/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Examples of usage

After loading the toolkit server, you can perform available actions by calling the corresponding tool names from your MCP client. The toolkit supports encoding, geolocation, network checks, cryptographic operations, UUID generation, and QR code generation. Use the client’s standard MCP call pattern to pass the required parameters for each operation.

Notes on security and maintenance

Run the toolkit MCP server in production mode to enable optimized performance and proper logging. Keep Node.js and dependencies up to date, and monitor usage to respect any rate limits defined by the server.

Available tools

geolocate

Look up geolocation information for an IP address or domain. Includes caching and rate limiting controls to optimize performance.

checkConnectivity

Test connectivity to a given host and port to verify reachability and TCP readiness.

getSystemInfo

Retrieve current system information such as OS, architecture, and hostname.

getLoadAverage

Fetch the system load averages to monitor CPU and system load.

hashData

Generate cryptographic hashes using MD5, SHA-1, SHA-256, or SHA-512 for given input data.

generateUUID

Create and return a universally unique identifier (UUID).

generateQRCode

Create QR codes from input data in various formats (terminal, SVG, Base64).