IT Tools MCP Server

CI/CD Pipeline Docker Pulls Docker Image Size NPM Version NPM Downloads GitHub Release License GitHub Issues GitHub Last Commit Docker Platform GitHub Stars

📝 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 over 121 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.

📦 Installation & Setup

Using with VS Code

Quick Install:

Install in VS Code Install in VS Code Insiders

Install:

Open VS Code
Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
Type "MCP" and select "MCP: Add Server"
Choose "NPM Package" and enter: it-tools-mcp

Or manually add to your VS Code

Node

{ "mcp": { "servers": { "it-tools": { "command": "npx", "args": ["it-tools-mcp"], "env": {} } } } }

Docker

{ "mcp": { "servers": { "it-tools": { "command": "docker", "args": [ "run", "-i", "--rm", "--init", "--security-opt", "no-new-privileges:true", "--cap-drop", "ALL", "--read-only", "--user", "1001:1001", "--memory=256m", "--cpus=0.5", "--name", "it-tools-mcp", "wrenchpilot/it-tools-mcp:latest" ] } } }

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":"generate_uuid","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":"encode_base64","arguments":{"text":"Hello World"}}}' | \ docker run -i --rm wrenchpilot/it-tools-mcp:latest

� MCP Logging Capabilities

This server includes full MCP logging support with the following features:

Log Levels

debug (0): Detailed debug information
info (1): General information messages
notice (2): Normal but significant events
warning (3): Warning conditions
error (4): Error conditions
critical (5): Critical conditions
alert (6): Action must be taken immediately
emergency (7): System is unusable

Logging Tools

logging_setLevel: Change the minimum logging level at runtime
logging_status: View current logging configuration and available levels

Environment-Aware Behavior

Development Mode: Debug level by default, enhanced console output
Production Mode: Info level by default, clean output for MCP compliance
Automatic Fallback: Console logging when MCP transport isn't ready

Usage Examples

# Check current logging status echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"logging_status","arguments":{}}}' | npx it-tools-mcp # Change log level to debug echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"logging_setLevel","arguments":{"level":"debug"}}}' | npx it-tools-mcp # Change log level to error (only show errors and above) echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"logging_setLevel","arguments":{"level":"error"}}}' | npx it-tools-mcp

🔧 MCP Protocol Utilities

This server implements the complete MCP 2025-06-18 specification including advanced utilities:

Ping Utility

Health Checking: Use ping requests to verify connection status
Automatic Response: Server responds promptly with empty result per MCP spec
Connection Monitoring: Implement periodic health checks

Progress Tracking

Long-Running Operations: Receive progress updates for time-consuming tasks
Progress Tokens: Include _meta.progressToken in requests to enable progress notifications
Notifications: Server sends notifications/progress with current status

Request Cancellation

Graceful Cancellation: Send notifications/cancelled to abort in-progress requests
Resource Cleanup: Server properly frees resources when requests are cancelled
Race Condition Handling: Robust handling of timing edge cases

Sampling Support

LLM Integration: Server can request LLM completions from clients using sampling/createMessage
Model Preferences: Support for model selection hints and capability priorities (cost, speed, intelligence)
Content Types: Support for text, image, and audio content in sampling requests
Agentic Workflows: Enable AI-powered tool operations through nested LLM calls
Client Control: Clients maintain full control over model access and user approval

Protocol Examples

# Test connection health with ping echo '{"jsonrpc":"2.0","id":1,"method":"ping"}' | npx it-tools-mcp # Request with progress tracking echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"some_tool","arguments":{},"_meta":{"progressToken":"track123"}}}' | npx it-tools-mcp # Cancel a request (send as notification) echo '{"jsonrpc":"2.0","method":"notifications/cancelled","params":{"requestId":"2","reason":"User cancelled"}}' | npx it-tools-mcp # Test sampling capabilities echo '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"mcp_sampling_demo","arguments":{"message":"What is the capital of France?","modelPreference":"claude","systemPrompt":"You are a helpful assistant.","maxTokens":100}}}' | npx it-tools-mcp # Demo MCP utilities echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"mcp_utilities_demo","arguments":{"operation":"ping"}}}' | npx it-tools-mcp

�🛠️ Tool Categories

This MCP server provides over 121 tools across 14 categories:

� Ansible Tools (5 tools): Vault encryption/decryption, inventory parser, playbook validator, reference
🎨 Color Tools (2 tools): Hex ↔ RGB conversion
📝 Data Format (12 tools): JSON, XML, YAML, SQL, TOML, Markdown ↔ HTML conversion, phone formatting
�️ Development Tools (6 tools): Regex testing, cron generation, list conversion, code prettifiers, markdown TOC
🐳 Docker Tools (5 tools): Compose validation, conversion tools, Traefik generator, reference
🔧 Encoding & Decoding (8 tools): Base64, URL, HTML entities, text-to-binary
🔍 Forensic Tools (3 tools): File type identification, safelink decoding, URL fanger
🆔 ID & Code Generators (4 tools: UUID, ULID, QR codes, SVG placeholders
🔢 Math & Calculations (6 tools): Expression evaluation, base conversion, temperature, percentages, Unix timestamps, Roman numerals
🌐 Network & System (23 tools): IPv4/IPv6 subnets, URL parsing, MAC addresses, ps, top, cat, head, tail, grep, ping, nslookup, telnet, dig, ssh, scp, curl, IBAN validation
⚡ Physics (3 tools): Angle, energy, and power unit conversions
🔐 Security & Crypto (12 tools): Hashing (MD5, SHA1, SHA256, SHA512), HMAC, JWT, bcrypt, passwords, tokens, OTP, BIP39
✨ Text Processing (19 tools): Case conversion, stats, diff, ASCII art, NATO alphabet, slugify, Unicode
🛠️ Utility Tools (7 tools): Email normalization, MIME types, HTTP status codes, device info, CSS prettifier, rem/px converter

📸 Screenshot Examples

Password Hash Generation Example

Password Hash Example

ASCII Art Text Generation Example

ASCII Art Text Example

Examples of using the IT Tools MCP server with VS Code Copilot Chat for secure password hashing and creative ASCII art generation.

Available Tools

Tool	Description	Parameters
Ansible Tools
`parse_ansible_inventory`	Parse Ansible inventory	`inventory: string`
`generate_ansible_inventory`	Generate Ansible inventory	`hosts: string[]` , `groups?: Record<string, string[]>` , `variables?: Record<string, any>`
`validate_ansible_playbook`	Validate Ansible playbook YAML	`playbook: string`
`show_ansible_reference`	Ansible syntax and module reference	`query?: string`
`decrypt_ansible_vault`	Decrypt Ansible Vault data	`data: string` , `password: string`
`encrypt_ansible_vault`	Encrypt data with Ansible Vault	`data: string` , `password: string`
Color Tools
`convert_hex_to_rgb`	Convert HEX to RGB	`hex: string`
`convert_rgb_to_hex`	Convert RGB to HEX	`r: number` , `g: number` , `b: number`
Data Format
`convert_html_to_markdown`	Convert HTML to Markdown	`html: string`
`compare_json`	Compare JSON objects	`json1: string` , `json2: string`
`format_json`	Format and validate JSON	`json: string` , `indent?: number`
`minify_json`	Minify JSON	`json: string`
`convert_json_to_csv`	Convert JSON to CSV	`json: string` , `delimiter?: string`
`convert_json_to_toml`	Convert JSON to TOML	`json: string`
`convert_markdown_to_html`	Convert Markdown to HTML	`markdown: string`
`format_phone`	Parse and format phone numbers	`phoneNumber: string` , `countryCode?: string`
`format_sql`	Format SQL	`sql: string` , `dialect?: 'sql' \| 'mysql' \| 'postgresql' \| 'sqlite' \| 'mariadb' \| 'db2' \| 'plsql' \| 'n1ql' \| 'redshift' \| 'spark' \| 'tsql' \| 'trino' \| 'bigquery'` (optional, default: 'sql')
`convert_toml_to_json`	Convert TOML to JSON	`toml: string`
`format_xml`	Format XML	`xml: string` , `indent?: number`
`format_yaml`	Format YAML	`yaml: string`
Development Tools
`generate_crontab`	Generate cron expressions	`minute?: string` , `hour?: string` , `dayOfMonth?: string` , `month?: string` , `dayOfWeek?: string`
`format_html`	Format and prettify HTML	`html: string` , `indent?: number`
`format_javascript`	Format and prettify JavaScript	`javascript: string` , `indent?: number`
`convert_list`	Convert list formats	`list: string` , `inputFormat: 'comma' \| 'semicolon' \| 'newline' \| 'space' \| 'pipe'` , `outputFormat: 'comma' \| 'semicolon' \| 'newline' \| 'space' \| 'pipe' \| 'json' \| 'quoted'` , `trim?: boolean`
`generate_markdown_toc`	Generate table of contents for Markdown	`markdown: string` , `maxDepth?: number`
`test_regex`	Test regular expressions	`pattern: string` , `text: string` , `flags?: string`
Docker Tools
`convert_docker_compose_to_run`	Convert Compose to Docker run command	`compose: string` , `service?: string`
`validate_docker_compose`	Validate Docker Compose YAML	`compose: string`
`show_docker_reference`	Docker command and syntax reference	`query?: string`
`convert_docker_run_to_compose`	Convert Docker run to Compose	`command: string`
`generate_traefik_compose`	Generate Traefik Docker Compose	`domain: string` , `service: string` , `port?: number` , `network?: string`
Encoding & Decoding
`decode_base64`	Decode Base64 text	`text: string`
`encode_base64`	Encode text to Base64	`text: string`
`decode_html`	Decode HTML entities	`text: string`
`encode_html`	Encode HTML entities	`text: string`
`encode_html_entities`	Extended HTML entity encoding/decoding	`text: string` , `operation: 'encode' \| 'decode'`
`convert_text_to_binary`	Convert text to binary and vice versa	`input: string` , `operation: 'encode' \| 'decode'`
`convert_text_to_unicode`	Convert text to Unicode and vice versa	`input: string` , `operation: 'encode' \| 'decode'`
`decode_url`	URL decode text	`text: string`
`encode_url`	URL encode text	`text: string`
Forensic Tools
`identify_file_type`	Identify file type from content	`data: string` , `filename?: string`
`decode_safelink`	Decode Microsoft SafeLinks	`url: string`
`fang_url`	Fang and defang URLs for analysis	`text: string` , `operation: 'fang' \| 'defang'`
ID & Code Generators
`generate_qr_code`	Generate QR codes for any content	`text: string` , `size?: number` - Supports URLs, WiFi (WIFI:T:WPA;S:network;P:password;;), contact info, etc.
`generate_svg_placeholder`	Generate SVG placeholder	`width?: number` , `height?: number` , `text?: string` , `backgroundColor?: string` , `textColor?: string`
`generate_ulid`	Generate ULID	None
`generate_uuid`	Generate UUID v4	None
Math & Calculations
`evaluate_math`	Evaluate expressions	`expression: string`
`convert_number_base`	Convert number bases	`number: string` , `fromBase: number` , `toBase: number`
`calculate_percentage`	Calculate percentages	`operation: 'percentage-of' \| 'what-percentage' \| 'percentage-change'` , `value1: number` , `value2: number`
`convert_roman_numerals`	Convert Roman numerals	`input: string`
`convert_temperature`	Convert temperatures	`temperature: number` , `from: 'celsius' \| 'fahrenheit' \| 'kelvin'` , `to: 'celsius' \| 'fahrenheit' \| 'kelvin'`
`convert_unix_timestamp`	Convert timestamps	`input: string`
Network & System
`cat`	Display file content	`file: string`
`curl`	HTTP client (GET, POST, etc.)	`url: string` , `method?: string` , `headers?: Record<string, string>` , `body?: string`
`dig`	DNS query (custom type)	`target: string` , `type?: string`
`grep`	Search for pattern in file	`file: string` , `pattern: string`
`head`	Show first N lines of file	`file: string` , `lines?: number`
`validate_iban`	Validate IBAN	`iban: string`
`calculate_ip_subnet`	Calculate IPv4 subnet	`ip: string` , `cidr: number`
`calculate_ipv4_subnet`	Enhanced IPv4 subnet calc	`cidr: string`
`generate_ipv6_ula`	Generate IPv6 ULA	`globalId?: string`
`generate_mac_address`	Generate MAC address	`prefix?: string` , `separator?: ':' \| '-'`
`nslookup`	DNS lookup (A/AAAA/CNAME)	`target: string`
`ping`	Ping a host	`target: string` , `count?: number`
`ps`	List running processes	None
`generate_random_port`	Generate random ports	`count?: number` , `min?: number` , `max?: number` , `exclude?: number[]`
`scp`	Copy files to/from remote host (SFTP)	`target: string` , `user: string` , `direction: 'upload'\|'download'` , `localPath: string` , `remotePath: string` , `privateKey?: string`
`ssh`	SSH command execution	`target: string` , `user: string` , `command: string`
`tail`	Show last N lines of file	`file: string` , `lines?: number`
`telnet`	Test TCP connectivity	`target: string` , `port: number`
`top`	Show top processes (by CPU)	None
`parse_url`	Parse URL components	`url: string`
Physics
`convert_angle`	Convert angle units	`value: number` , `from: 'degrees' \| 'radians' \| 'gradians'` , `to: 'degrees' \| 'radians' \| 'gradians'`
`convert_energy`	Convert energy units	`value: number` , `from: 'joules' \| 'calories' \| 'kwh' \| 'btu'` , `to: 'joules' \| 'calories' \| 'kwh' \| 'btu'`
`convert_power`	Convert power units	`value: number` , `from: 'watts' \| 'kilowatts' \| 'horsepower' \| 'btu_per_hour'` , `to: 'watts' \| 'kilowatts' \| 'horsepower' \| 'btu_per_hour'`
Security & Crypto
`generate_basic_auth`	Generate Basic Auth header	`username: string` , `password: string`
`hash_bcrypt`	Generate/verify bcrypt hash	`password: string` , `rounds?: number` , `hash?: string`
`generate_bip39`	Generate BIP39 mnemonic	`wordCount?: '12' \| '15' \| '18' \| '21' \| '24'`
`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`
`generate_hmac`	Generate HMAC	`message: string` , `key: string` , `algorithm?: 'sha1' \| 'sha256' \| 'sha512'`
`decode_jwt`	Decode JWT token	`token: string`
`generate_otp`	Generate TOTP codes	`secret: string` , `digits?: number` , `period?: number`
`generate_password`	Generate secure password	`length?: number` , `includeUppercase?: boolean` , `includeLowercase?: boolean` , `includeNumbers?: boolean` , `includeSymbols?: boolean`
`generate_token`	Generate secure token	`length?: number` , `charset?: 'alphanumeric' \| 'hex' \| 'base64' \| 'custom'` , `customChars?: string`
Text Processing
`generate_ascii_art`	Generate ASCII art	`text: string` , `font?: string` (supports 295+ figlet fonts)
`analyze_distinct_words`	Extract unique words from text	`text: string` , `caseSensitive?: boolean`
`search_emoji`	Search emojis	`query: string`
`generate_lorem_ipsum`	Generate Lorem Ipsum	`type?: 'words' \| 'sentences' \| 'paragraphs'` , `count?: number`
`generate_numeronym`	Generate numeronyms	`text: string`
`slugify_text`	Convert to URL slug	`text: string` , `separator?: string` , `lowercase?: boolean`
`obfuscate_string`	Obfuscate text	`text: string` , `method?: 'html-entities' \| 'unicode' \| 'base64'`
`convert_to_camelcase`	Convert to camelCase	`text: string`
`capitalize_text`	Capitalize words	`text: string`
`compare_text`	Compare texts	`text1: string` , `text2: string`
`convert_text_to_kebabcase`	Convert to kebab-case	`text: string`
`convert_text_to_lowercase`	Convert to lowercase	`text: string`
`convert_text_to_pascalcase`	Convert to PascalCase	`text: string`
`text_snakecase`	Convert to snake_case	`text: string`
`analyze_text_stats`	Get text statistics	`text: string`
`convert_text_to_nato`	Convert to NATO alphabet	`text: string`
`show_unicode_names`	Convert text to Unicode character names	`text: string`
`convert_text_to_uppercase`	Convert to uppercase	`text: string`
Utility Tools
`format_css`	Format and prettify CSS	`css: string` , `indent?: number`
`show_device_info`	Get system information	None
`normalize_email`	Normalize email addresses	`email: string`
`lookup_http_status`	HTTP status reference	`code?: number`
`lookup_mime_types`	Look up MIME types	`input: string` , `lookupType?: 'extension-to-mime' \| 'mime-to-extension'`
`lookup_port_numbers`	Look up port number assignments	`port?: number` , `service?: string`
`convert_rem_px`	Convert between REM and PX units	`value: number` , `conversion: 'rem-to-px' \| 'px-to-rem'` , `baseFontSize?: 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 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 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

Create a tool directory in appropriate category under src/tools/
Define tool with input schema using Zod in its index.ts
Export registration function for dynamic loading
Rebuild with npm run build

Project Structure

src/ ├── index.ts # Main MCP server with dynamic tool loading └── tools/ # Modular tool categories ├── ansible/ # 5 Ansible automation tools ├── color/ # 2 Color conversion tools ├── crypto/ # 9 Cryptographic & security tools ├── dataFormat/ # 12 Data format conversion tools ├── development/ # 6 Development utilities ├── docker/ # 5 Docker & containerization tools ├── encoding/ # 8 Encoding/decoding tools ├── forensic/ # 3 Digital forensics tools ├── idGenerators/ # 4 ID & code generation tools ├── math/ # 6 Mathematical operation tools ├── network/ # 23 Network utilities ├── physics/ # 3 Physics calculation tools ├── text/ # 19 Text manipulation tools └── utility/ # 7 General utility tools

🤝 Contributing

Contributions are welcome! Please follow the guidelines below:

Commit Message Format

This project uses Conventional Commits for clear, consistent commit messages.

Version Management:

🤖 Automatic version bumping - Git hooks automatically bump versions based on commit message types
🤖 Automatic publishing - CI/CD detects changes and publishes automatically
🏷️ Git tags - Created automatically based on conventional commit messages

Examples:

git commit -m "feat: add new encryption tool" # → minor version bump git commit -m "fix: resolve base64 decoding issue" # → patch version bump git commit -m "docs: improve README examples" # → patch version bump git commit -m "feat!: breaking API change" # → major version bump # Version is automatically bumped and committed by git hooks # No manual npm version commands needed! git push

📖 See COMMIT_TEMPLATE_SETUP.md for setup instructions.

Development Process

Fork the repository
Run ./setup-commit-template.sh (recommended)
Create a feature branch
Make your changes following the project structure
Use conventional commit messages
Submit a Pull Request

The CI/CD pipeline will automatically:

✅ Build and test your changes
🏷️ Bump version based on commit messages (on merge to main)
📦 Publish to Docker Hub and NPM
🚀 Create GitHub releases

📄 License

MIT License - see LICENSE for details.

🔗 Related

Inspired by IT Tools - online tools for developers.

This project incorporates select tools from the @sharevb fork which extends IT Tools with additional utilities and enhancements.

Deploy 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 (MCP) server that provides access to 87 IT tools and utilities commonly used by developers, system administrators, and IT professionals. Inspired by https://github.com/CorentinTh/it-tools

Related Resources

Reddit Discussion about this server

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
2
MIT License
Playwright MCP Serverofficial
microsoft
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Last updated -
24
524,380
22,364
Apache 2.0
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
22
MIT License
MCP Server
srafi26
A
security
F
license
A
quality
A Model Context Protocol server implementation that provides basic utility tools including echo, uppercase text conversion, and mathematical calculations.
Last updated -
3
596

View all related MCP servers