mcp-helper-tools

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • The MCP server is hosted on GitHub and references the repository for source code access and contributions.

  • Enables generation of QR codes in SVG format through the MCP server's generator tools.

  • The MCP server is built with TypeScript 5.3, allowing for type-safe development and integration.

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

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 git@github.com: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.


-
security - not tested
A
license - permissive license
-
quality - not tested

Fork of @cyanheads toolkit MCP server. Added encoding functions, removed system network functions.

  1. Model Context Protocol
    1. Table of Contents
      1. Features
        1. Encoding Tools
          1. Network & Geolocation
            1. Security Tools
              1. Generator Tools
              2. Installation
                1. Configuration
                  1. Tools
                    1. Network Operations
                      1. System Operations
                        1. Security Operations
                          1. Generator Operations
                          2. Contributing
                            1. License