Helper Tools

🚀 mcp-helper-tools Based on toolkit-mcp-server

A Model Context Protocol server that provides utility tools and functions for the LLM Agent system, including IP geolocation, network diagnostics, system monitoring, encryption operations, and QR code generation.

🚀 Quick Start

This mcp-helper-tools based on toolkit-mcp-server offers a range of useful features for the LLM Agent system. It simplifies tasks related to encoding, network operations, security, and generation.

✨ Features

Coding Tools

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

Network and Geolocation

• Smart-cached IP geolocation
• 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 code
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"
      }
    }
  }
}

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

System Operations

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

🔍 Model Context Protocol

The Model Context Protocol (MCP) enables communication between clients and servers:

• Clients: Claude Desktop, IDEs, and other MCP-compatible clients
• Servers: Task management and automation tools and resources
• LLM Agent: AI models that utilize server capabilities

🤝 Contributing

If you'd like to contribute, please refer to the project repository: https://github.com/cyanheads/toolkit-mcp-server

📄 License

This project is licensed under the Apache 2.0 license. For detailed information, please refer to the LICENSE file.