# mcp-helper-tools

based on toolkit-mcp-server

[\](https://www.typescriptlang.org/) [\](https://modelcontextprotocol.io/) [\]() [\](https://opensource.org/licenses/Apache-2.0) [\]() [\](https://github.com/cyanheads/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](#features)
• [Installation](#installation)
• [Configuration](#configuration)
• [Tools](#tools)
• [Contributing](#contributing)
• [License](#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

```bash

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:

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

Tools

Network Operations

```typescript // 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

```typescript // 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

```typescript // 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

```typescript // 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](LICENSE) for more information.

Built with the Model Context Protocol