IT Tools MCP Server

📝 Note: A condensed version of this README is automatically synced to Docker Hub due to character limits.

A comprehensive Model Context Protocol (MCP) server that provides access to 70+ IT tools and utilities commonly used by developers, system administrators, and IT professionals. This server exposes a complete set of tools for encoding/decoding, text manipulation, hashing, network utilities, and many other common development and IT tasks.

🚀 Quick Start

Using Docker (Recommended)

# Pull and run the latest version
docker run -it --rm wrenchpilot/it-tools-mcp:latest

# Or use docker-compose
curl -O https://raw.githubusercontent.com/wrenchpilot/it-tools-mcp/main/docker-compose.yml
docker-compose up

Using Docker with Persistent Data

docker run -it --rm \
  -v $(pwd)/data:/app/data \
  wrenchpilot/it-tools-mcp:latest

Usage Examples

Interactive Mode

docker run -it --rm wrenchpilot/it-tools-mcp:latest

Programmatic Usage

# Generate a UUID
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"uuid-generate","arguments":{}}}' | \
  docker run -i --rm wrenchpilot/it-tools-mcp:latest

# Encode text to Base64
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"base64-encode","arguments":{"text":"Hello World"}}}' | \
  docker run -i --rm wrenchpilot/it-tools-mcp:latest

🛠️ Tool Categories

This MCP server provides 76 tools across 8 categories:

🔧 Encoding & Decoding (9 tools): Base64, URL, HTML entities, text-to-binary, Unicode
📝 Data Format (11 tools): JSON, XML, YAML, SQL, TOML, Markdown ↔ HTML conversion
🔐 Security & Crypto (12 tools): Hashing (MD5, SHA1-512), HMAC, JWT, bcrypt, passwords, tokens
✨ Text Processing (16 tools): Case conversion, stats, diff, ASCII art, NATO alphabet, slugify
🌐 Network & Web (8 tools): IPv4/IPv6 subnets, URL parsing, MAC addresses, phone formatting
🔢 Math & Calculations (6 tools): Expression evaluation, base conversion, temperature, percentages
🆔 ID & Code Generators (5 tools: UUID, ULID, QR codes, WiFi QR, SVG placeholders
🔧 Development & Utilities (9 tools): Regex testing, cron expressions, color conversion, MIME types

📦 Installation & Setup

Using with Claude Desktop

Add to your claude_desktop_config.json:

  "mcpServers": {
    "it-tools": {
      "command": "docker",
      "args": [
          "run",
          "-i",
          "--rm",
          "--name",
          "it-tools-mcp",
          "wrenchpilot/it-tools-mcp:latest"
      ]
    }
  }

Using with VS Code

Add to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "it-tools": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "wrenchpilot/it-tools-mcp:latest"]
      }
    }
  }
}

Then restart VS Code and the IT Tools will be available in Copilot Chat with #[tool-name] prefix.

Local Development

git clone https://github.com/wrenchpilot/it-tools-mcp.git
cd it-tools-mcp
npm install
npm run build
npm start

💡 Usage Examples

Ask Claude to use these tools:

Encoding: "Base64 encode 'Hello World'" → SGVsbG8gV29ybGQ=
Hashing: "Generate SHA256 hash for 'password123'"
Formatting: "Format this JSON: {'name':'John','age':30}"
Text: "Convert 'hello world' to camelCase" → helloWorld
Security: "Generate a 16-character password with symbols"
Network: "Calculate subnet info for 192.168.1.0/24"
Colors: "Convert HEX color #FF5733 to RGB" → rgb(255, 87, 51)
IDs: "Generate a UUID" → 550e8400-e29b-41d4-a716-446655440000

📸 Screenshot Examples

Password Hash Generation Example

Password Hash Example

Example of using the IT Tools MCP server to generate secure password hashes with VS Code Copilot Chat

Available Tools

Tool	Description	Parameters
Encoding & Decoding
`base64-encode`	Encode text to Base64	`text: string`
`base64-decode`	Decode Base64 text	`text: string`
`url-encode`	URL encode text	`text: string`
`url-decode`	URL decode text	`text: string`
`html-encode`	Encode HTML entities	`text: string`
`html-decode`	Decode HTML entities	`text: string`
`html-entities-extended`	Extended HTML entity encoding/decoding	`text: string`, `operation: 'encode' \| 'decode'`
`text-to-binary`	Convert text to binary and vice versa	`input: string`, `operation: 'encode' \| 'decode'`
`text-to-unicode`	Convert text to Unicode and vice versa	`input: string`, `operation: 'encode' \| 'decode'`
Data Format
`json-format`	Format and validate JSON	`json: string`, `indent?: number`
`json-minify`	Minify JSON	`json: string`
`json-to-csv`	Convert JSON to CSV	`json: string`, `delimiter?: string`
`json-to-toml`	Convert JSON to TOML	`json: string`
`json-diff`	Compare JSON objects	`json1: string`, `json2: string`
`xml-format`	Format XML	`xml: string`, `indent?: number`
`yaml-format`	Format YAML	`yaml: string`
`sql-format`	Format SQL	`sql: string`
`toml-to-json`	Convert TOML to JSON	`toml: string`
`markdown-to-html`	Convert Markdown to HTML	`markdown: string`
`html-to-markdown`	Convert HTML to Markdown	`html: string`
Security & Crypto
`hash-md5`	Generate MD5 hash	`text: string`
`hash-sha1`	Generate SHA1 hash	`text: string`
`hash-sha256`	Generate SHA256 hash	`text: string`
`hash-sha512`	Generate SHA512 hash	`text: string`
`hmac-generator`	Generate HMAC	`message: string`, `key: string`, `algorithm?: 'sha1' \| 'sha256' \| 'sha512'`
`jwt-decode`	Decode JWT token	`token: string`
`basic-auth-generator`	Generate Basic Auth header	`username: string`, `password: string`
`bcrypt-hash`	Generate/verify bcrypt hash	`password: string`, `rounds?: number`, `hash?: string`
`bip39-generate`	Generate BIP39 mnemonic	`wordCount?: '12' \| '15' \| '18' \| '21' \| '24'`
`password-generate`	Generate secure password	`length?: number`, `includeUppercase?: boolean`, `includeLowercase?: boolean`, `includeNumbers?: boolean`, `includeSymbols?: boolean`
`token-generator`	Generate secure token	`length?: number`, `charset?: 'alphanumeric' \| 'hex' \| 'base64' \| 'custom'`, `customChars?: string`
`otp-code-generator`	Generate TOTP codes	`secret: string`, `digits?: number`, `period?: number`
Text Processing
`text-uppercase`	Convert to uppercase	`text: string`
`text-lowercase`	Convert to lowercase	`text: string`
`text-capitalize`	Capitalize words	`text: string`
`text-camelcase`	Convert to camelCase	`text: string`
`text-pascalcase`	Convert to PascalCase	`text: string`
`text-kebabcase`	Convert to kebab-case	`text: string`
`text-snakecase`	Convert to snake_case	`text: string`
`text-stats`	Get text statistics	`text: string`
`text-diff`	Compare texts	`text1: string`, `text2: string`
`ascii-art-text`	Generate ASCII art	`text: string`, `font?: 'small' \| 'standard' \| 'big'`
`text-to-nato-alphabet`	Convert to NATO alphabet	`text: string`
`string-obfuscator`	Obfuscate text	`text: string`, `method?: 'html-entities' \| 'unicode' \| 'base64'`
`slugify-string`	Convert to URL slug	`text: string`, `separator?: string`, `lowercase?: boolean`
`lorem-ipsum-generator`	Generate Lorem Ipsum	`type?: 'words' \| 'sentences' \| 'paragraphs'`, `count?: number`
`numeronym-generator`	Generate numeronyms	`text: string`
`emoji-search`	Search emojis	`query: string`
Network & Web
`ip-subnet-calculator`	Calculate IPv4 subnet	`ip: string`, `cidr: number`
`ipv4-subnet-calc`	Enhanced IPv4 subnet calc	`cidr: string`
`ipv6-ula-generator`	Generate IPv6 ULA	`globalId?: string`
`url-parse`	Parse URL components	`url: string`
`random-port`	Generate random ports	`count?: number`, `min?: number`, `max?: number`, `exclude?: number[]`
`mac-address-generate`	Generate MAC address	`prefix?: string`, `separator?: ':' \| '-'`
`phone-format`	Format phone numbers	`phoneNumber: string`, `countryCode?: string`
`iban-validate`	Validate IBAN	`iban: string`
Math & Calculations
`math-evaluate`	Evaluate expressions	`expression: string`
`number-base-converter`	Convert number bases	`number: string`, `fromBase: number`, `toBase: number`
`roman-numeral-converter`	Convert Roman numerals	`input: string`
`temperature-converter`	Convert temperatures	`temperature: number`, `from: 'celsius' \| 'fahrenheit' \| 'kelvin'`, `to: 'celsius' \| 'fahrenheit' \| 'kelvin'`
`percentage-calculator`	Calculate percentages	`operation: 'percentage-of' \| 'what-percentage' \| 'percentage-change'`, `value1: number`, `value2: number`
`unix-timestamp-converter`	Convert timestamps	`input: string`
ID & Code Generators
`uuid-generate`	Generate UUID v4	None
`ulid-generate`	Generate ULID	None
`qr-generate`	Generate QR code	`text: string`, `size?: number`
`wifi-qr-code-generator`	Generate WiFi QR	`ssid: string`, `password: string`, `security?: 'WPA' \| 'WEP' \| 'nopass'`, `hidden?: boolean`
`svg-placeholder-generator`	Generate SVG placeholder	`width?: number`, `height?: number`, `text?: string`, `backgroundColor?: string`, `textColor?: string`
Development Tools
`regex-tester`	Test regular expressions	`pattern: string`, `text: string`, `flags?: string`
`crontab-generate`	Generate cron expressions	`minute?: string`, `hour?: string`, `dayOfMonth?: string`, `month?: string`, `dayOfWeek?: string`
`list-converter`	Convert list formats	`list: string`, `inputFormat: 'comma' \| 'semicolon' \| 'newline' \| 'space' \| 'pipe'`, `outputFormat: 'comma' \| 'semicolon' \| 'newline' \| 'space' \| 'pipe' \| 'json' \| 'quoted'`, `trim?: boolean`
Utility Tools
`color-hex-to-rgb`	Convert HEX to RGB	`hex: string`
`color-rgb-to-hex`	Convert RGB to HEX	`r: number`, `g: number`, `b: number`
`email-normalizer`	Normalize email addresses	`email: string`
`mime-types`	Look up MIME types	`input: string`, `lookupType?: 'extension-to-mime' \| 'mime-to-extension'`
`device-info`	Get system information	None
`http-status-codes`	HTTP status reference	`code?: number`

🏗️ Architecture & Development

Built with TypeScript, Zod validation, and MCP SDK for robust, type-safe operation.

🤖 AI-Assisted Development

This project was developed using VS Code, Copilot Chat Agent, Playwright MCP, and the Claude Sonnet 4 Model, demonstrating the power of AI-assisted software development:

Intelligent Code Generation: Claude Sonnet analyzed requirements and generated comprehensive tool implementations
Schema Validation: Automatically identified and resolved JSON schema validation issues across 76 tools
Docker Optimization: Created production-ready Docker workflows and multi-stage builds
Documentation: Generated comprehensive README with examples and tool reference tables
Testing: Implemented robust error handling and validation throughout the codebase

Key AI Contributions:

🔧 Tool Implementation: All 76 tools designed and implemented with AI assistance
📦 Docker Setup: Complete containerization with GitHub Actions CI/CD pipeline
🔍 Schema Cleanup: Systematic removal of unsupported Zod keywords from all tool definitions
📚 Documentation: Comprehensive README with usage examples and tool catalogs
🚀 Production Ready: Docker Hub publishing, badges, and professional deployment setup

This showcases how AI can accelerate development while maintaining code quality, proper architecture, and comprehensive testing.

Adding New Tools

Choose/create a tool module in src/tools/
Define tool with input schema using Zod
Register in src/index.ts
Rebuild with npm run build

Project Structure

src/
├── index.ts              # Main MCP server
└── tools/                # Tool modules by category
    ├── encoding.ts       # Base64, URL, HTML encoding
    ├── crypto.ts         # Hashing, JWT, passwords
    ├── dataFormat.ts     # JSON, XML, YAML processing
    ├── text.ts           # Text manipulation tools
    ├── network.ts        # Network utilities
    ├── math.ts           # Mathematical operations
    ├── idGenerators.ts   # UUID, ULID, QR codes
    └── utility.ts        # Color, MIME, HTTP tools

🤝 Contributing

Contributions welcome! Please submit a Pull Request.

📄 License

MIT License - see LICENSE for details.

Inspired by IT Tools - online tools for developers.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

A comprehensive Model Context Protocol server providing access to 70+ IT tools for developers and system administrators, including encoding/decoding, text manipulation, hashing, and network utilities.

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
Python
MIT License
CodeAnalysis MCP Server
0xjcf
A
security
F
license
A
quality
A comprehensive Model Context Protocol server for advanced code analysis that provides tools for syntax analysis, dependency visualization, and AI-assisted development workflow support.
Last updated -
28
3
Python
Code Merge MCP
yy1588133
A
security
A
license
A
quality
A Model Context Protocol server that helps large language models process code repositories by providing file tree generation, code merging, and code analysis capabilities.
Last updated -
3
14
JavaScript
MIT License
MCP Server.exe
shadowcz007
-
security
A
license
-
quality
A powerful executable server for running Model Context Protocol services that supports tool chain execution, multiple MCP services management, and a pluggable tool system for complex automation workflows.
Last updated -
169
44
TypeScript
MIT License

View all related MCP servers

IT Tools MCP Server