MCP Helper Tools

🚀 mcp-helper-tools

A Model Context Protocol (MCP) server that provides system utilities and functions for large language model agents, including IP geolocation, network diagnostics, system monitoring, encryption operations, and QR code generation.

🚀 Quick Start

The Model Context Protocol (MCP) server is based on the toolkit-mcp-server toolkit. It enables communication between clients, servers, and large language model agents, providing a variety of useful tools and functions.

✨ Features

Coding Tools

• Base64 encoding/decoding
• URL encoding/decoding
• HTML encoding/decoding

Network and Geolocation

• IP geolocation with intelligent caching
• Rate limiting (45 requests per minute)

Security Tools

• Encryption hash generation (MD5, SHA-1, SHA-256, SHA-512)
• Constant-time hash comparison
• UUID generation

Generator Tools

• QR code generation
  • Terminal output
  • SVG format
  • Base64-encoded image

📦 Installation

# 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

📚 Documentation

Configuration

Add the following to your MCP client settings:

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

Tool Usage

Network Operations

// Get geolocation data
const geo = await mcp.use('toolkit-mcp-server', 'geolocate', {
  query: '8.8.8.8'
});

// Check connectivity
const conn = await mcp.use('toolkit-mcp-server', 'checkConnectivity', {
  host: 'example.com',
  port: 443,
  timeout: 5000
});

System Operations

// Get system information
const systemInfo = await mcp.use('toolkit-mcp-server', 'getSystemInfo');
// Monitor disk usage
const diskUsage = await mcp.use('toolkit-mcp-server', 'monitorDiskUsage', {
  path: '/',
  interval: 10000
});

Security Operations

// Verify file signature
const isValid = await mcp.use('toolkit-mcp-server', 'verifyFileSignature', {
  file: '/path/to/file',
  publicKey: 'public-key-pem'
});

Generator Operations

// Generate QR code
const qrCode = await mcp.use('toolkit-mcp-server', 'generateQRCode', {
  data: 'https://example.com',
  size: '256x256'
});

🤝 Contribution

For contribution guidelines, please refer to CONTRIBUTING.md

📄 License

Apache License 2.0