Toolkit MCP Server

🚀 Toolkit MCP Server

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

🚀 Quick Start

The Toolkit MCP Server is a Model Context Protocol server designed to offer system utilities and functions for LLM agents. It supports various operations such as IP geolocation, network diagnostics, system monitoring, encryption, and QR code generation.

✨ Features

Network and Geolocation

• IP geolocation with intelligent caching
• Network connectivity testing
• Ping and Traceroute tools for diagnostics
• Public IP detection
• Rate limiting (45 requests per minute)

System Utilities

• System information query
• Resource monitoring
• Load average tracking
• Network interface details

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 format
  • SVG format
  • Base64-encoded image

📦 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

📚 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 Diagnostics

# Get network interface information
curl http://localhost:3000/api/network/interfaces

# Get public IP address
curl http://localhost:3000/api/ip

System Monitoring

# Monitor CPU usage
curl http://localhost:3000/api/processes

# Query system information
curl http://localhost:3000/api/system

🤝 Contributing

We welcome contributions from the community! Please visit the GitHub repository to submit issues, feature requests, or pull requests.

📄 License

This project is licensed under the Apache 2.0 license. Please refer to the LICENSE file for details.