It Tools MCP

🚀 IT Tools MCP Server

A comprehensive Model Context Protocol (MCP) server that provides access to 112 IT tools and utilities commonly used by developers, system administrators, and IT professionals.

🚀 Quick Start

This IT Tools MCP Server offers a wide range of IT tools and utilities. You can integrate it with VS Code or use it in different modes such as interactive mode or programmatic usage.

✨ Features

• Rich Toolset: Provides 112 IT tools across 14 categories, covering various aspects like encoding/decoding, text manipulation, hashing, network utilities, etc.
• AI - Assisted Development: Developed with the help of AI, including intelligent code generation, schema validation, Docker optimization, and documentation generation.
• Flexible Installation: Can be installed and used with VS Code, Docker, or in programmatic ways.

📦 Installation

Using with VS Code

Add to your VS Code settings.json:

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":"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

💻 Usage Examples

Basic 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

Advanced Usage

# Use more complex tool combinations according to your needs. For example, generate a UUID and then encode it to Base64.
uuid=$(echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"uuid-generate","arguments":{}}}' | \
  docker run -i --rm wrenchpilot/it-tools-mcp:latest)
echo "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"base64-encode\",\"arguments\":{\"text\":$uuid}}}" | \
  docker run -i --rm wrenchpilot/it-tools-mcp:latest

🛠️ Tool Categories

This MCP server provides 112 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 of using the IT Tools MCP server with VS Code Copilot Chat for secure password hashing and creative ASCII art generation

ASCII Art Text Generation Example

Available Tools

🏗️ Architecture & Development

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

🤖 AI-Assisted Development

This project was developed using mainly VS Code, Copilot Chat Agent, Playwright MCP, and the Claude Sonnet 4 Model from Anthropic, showcasing 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 all 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 112 tools designed and implemented with AI assistance.
• 📦 Docker Setup: Complete containerization with GitHub Actions CI ⁄ CD pipeline setup.
• 🔍 Schema Cleanup: Systematic removal of unsupported Zod keywords from all tool definitions.
• 📚 Documentation: Comprehensive README with usage examples and tool catalogs developed.
• 🚀 Production Ready: Docker Hub publishing, badges, and professional deployment setup done.

Adding New Tools

How to add new tools to the project

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

Project Structure

src/
├── index.ts              # Main MCP server with dynamic tool loading 
└── tools/                # Modular tool categories 
    ├── ansible/          # Five Ansible automation tools 
    ├── color⁣/           # Two color conversion tools      
    ├── crypto⁣/          # Nine cryptographic & security tools 
    ├── dataFormat⁣/      # Twelve data format conversion tools 
    ├── development⁣/     # Six development utilities 
    ├── docker⁣/          # Five Docker & containerization tools 
    ├── encoding⁣/        # Eight encoding/decoding tools 
    ├── forensic⁣/        # Three digital forensics tools 
    ├── idGenerators⁣/    # Four ID & code generation tools 
    ├── math⁣/            # Six mathematical operation tools 
    ├── network⁣/         # Twenty - three network utilities 
    ├── physics⁣/         # Three physics calculation tools 
    ├── text⁣/            # Nineteen text manipulation tools 
    └── utility⁣/         # Seven 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

1. Fork the repository.
2. Run ./setup-commit-template.sh (recommended).
3. Create a feature branch.
4. Make your changes following the project structure.
5. Use conventional commit messages.
6. 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

This project is under the MIT License. See LICENSE for details.

🔗 Related

This project is inspired by IT Tools - online tools for developers. And it incorporates select tools from the @sharevb fork which extends IT Tools with additional utilities and enhancements.