About Mcp Helper Tools
Mcp Helper Tools is an MCP server for LLM agents, offering encoding, geolocation, cryptographic, and QR-code utilities. This fork adds encoding functions and removes system network functions.
Key features
- 01Base64, URL, and HTML encoding
- 02IP geolocation
- 03Hash generation and comparison
- 04UUID generation
- 05QR code generation
Use cases
- 01Convert Base64, URL, or HTML content
- 02Look up an IP's location
- 03Generate and compare data hashes
- 04Create QR codes or UUIDs
MCP support
The server exposes encoding, geolocation, security, and generator tools to MCP clients for use by LLM agents.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmcp-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 [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
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
Apache License 2.0. See LICENSE for more information.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.