What is Mcp Helper Tools

mcp-helper-tools is a Model Context Protocol server that provides LLM Agents with various system utilities and tools, including IP geolocation, network diagnostics, system monitoring, cryptographic operations, and QR code generation.

Use cases

Use cases include generating QR codes for applications, performing IP geolocation for analytics, conducting network diagnostics, and implementing cryptographic operations for secure data handling.

How to use

To use mcp-helper-tools, you can install it via npm with the command ‘npm install @cyanheads/toolkit-mcp-server’ or clone the repository from GitHub and build it from source.

Key features

Key features include encoding tools (Base64, URL, HTML), network and geolocation services (IP geolocation with caching), security tools (cryptographic hash generation, UUID generation), and generator tools (QR code generation in various formats).

Where to use

mcp-helper-tools can be used in various fields such as software development, network management, security applications, and any environment where automation and task management are required.

mcp-helper-tools

based on toolkit-mcp-server

A Model Context Protocol server providing LLM Agents with system utilities and tools, including IP geolocation, network diagnostics, system monitoring, cryptographic operations, and QR code generation.

Model Context Protocol

The Model Context Protocol (MCP) enables communication between:

• Clients: Claude Desktop, IDEs, and other MCP-compatible clients
• Servers: Tools and resources for task management and automation
• LLM Agents: AI models that leverage the server’s capabilities

Table of Contents

• Features
• Installation
• Configuration
• Tools
• Contributing
• License

Features

Encoding Tools

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

Network & Geolocation

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

Security Tools

• Cryptographic 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 images

Installation

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

# Or install from source
git clone [email protected]:cyanheads/toolkit-mcp-server.git
cd toolkit-mcp-server
npm install
npm run build

Configuration

Add to your MCP client settings:

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

Tools

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
});

System Operations

// Get system information
const sysInfo = await mcp.use('toolkit-mcp-server', 'getSystemInfo', {});

// Get load average
const load = await mcp.use('toolkit-mcp-server', 'getLoadAverage', {});

Security Operations

// Generate hash
const hash = await mcp.use('toolkit-mcp-server', 'hashData', {
  input: 'test data',
  algorithm: 'sha256'
});

// Generate UUID
const uuid = await mcp.use('toolkit-mcp-server', 'generateUUID', {});

Generator Operations

// Generate QR code
const qr = await mcp.use('toolkit-mcp-server', 'generateQRCode', {
  data: 'https://example.com',
  type: 'svg'
});

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

Apache License 2.0. See LICENSE for more information.