Toolkit

This MCP server provides a suite of tools for model agents, including geolocation, network diagnostics, system insights, cryptographic operations, and QR code generation. It enables secure, scriptable interactions with common utilities through the Model Context Protocol, helping you automate tasks and workflows with ease.

How to use

You use this server by connecting an MCP client to the toolkit MCP server and invoking its available endpoints. Start tasks that require geolocation, network testing, system information, cryptographic operations, or QR code generation, and receive structured results that you can feed into your automation pipelines or AI agents.

How to install

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

Install the toolkit MCP server package from npm:

npm install @cyanheads/toolkit-mcp-server

Or install from source and build the project, then prepare to run the server locally:

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 a configured MCP source. The following example shows how to reference the toolkit server so your client can call its endpoints.

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

Security and tips

This server exposes a range of utilities. Use them judiciously and respect rate limits to avoid overloading the service. When handling cryptographic operations, prefer the provided hash and UUID generators for consistent, reproducible results.

Examples and capabilities

Network operations include geolocation, connectivity checks, ping and traceroute utilities, and public IP detection. System operations cover system information and load averages. Security tools provide hash generation (MD5, SHA-1, SHA-256, SHA-512), constant-time hash comparison, and UUID generation. Generator tools offer QR code generation in terminal, SVG, and Base64 formats.

Available tools

geolocate

Fetch geolocation data for a given IP or hostname with intelligent caching to improve response times.

checkConnectivity

Test network connectivity to a specified host and port, returning status and latency information.

getSystemInfo

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

getLoadAverage

Provide the system load average metrics to help understand resource pressure.

hashData

Generate cryptographic hashes (MD5, SHA-1, SHA-256, SHA-512) for a given input.

generateUUID

Create a universally unique identifier (UUID) for tracking and correlation.

generateQRCode

Generate a QR code from input data in terminal, SVG, or Base64-encoded formats.