IT Tools

[!WARNING]This project is deprecated and no longer maintained.

It was built as a learning exercise to explore AI-assisted development and the Model Context Protocol (MCP). No further updates, bug fixes, or pull requests will be accepted. The repository is kept for reference only.

If you need an actively maintained MCP server with IT utilities, look for community alternatives.

📝 Note: A condensed version of this README is automatically synced toDocker Hubdue to character limits.

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

{ "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" ] } } }

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

# 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

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

- 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_setLevel: Change the minimum logging level at runtime
- logging_status: View current logging configuration and available levels

- 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

# 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

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

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

- Long-Running Operations: Receive progress updates for time-consuming tasks
- Progress Tokens: Include_meta.progressTokenin requests to enable progress notifications
- Notifications: Server sendsnotifications/progresswith current status

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

- LLM Integration: Server can request LLM completions from clients usingsampling/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

# 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

This MCP server provides over121 toolsacross14 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

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

Built withTypeScript,Zodvalidation, andMCP SDKfor robust, type-safe operation.

This project was developed usingVS Code,Copilot Chat Agent,Playwright MCP, and theClaude 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

- 🔧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.
- Create a tool directory in appropriate category undersrc/tools/
- Define tool with input schema using Zod in itsindex.ts
- Export registration function for dynamic loading
- Rebuild withnpm run build

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

This project is no longer accepting contributions.It is archived for reference purposes only. The guidelines below are preserved for historical context.

This project usesConventional Commitsfor clear, consistent commit messages.

- 🤖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

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

📖 SeeCOMMIT_TEMPLATE_SETUP.mdfor setup instructions.
- 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

Inspired byIT Tools- online tools for developers.

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

Model the realistic monthly cost of an LLM app before you build it. Not a token calculator: retries, prompt caching, batch discounts, infra overhead, and 3×/10× growth are modeled in, across GPT-5.x, Claude, Gemini, DeepSeek, and more. Works without a key. Connect and ask — demo mode covers the six free-tier models. A Pro API key (beforeyouship.dev) unlocks the full 18-model catalog.

Performs basic arithmetic calculations. A TypeScript-based server demonstrating core MCP concepts.

Debug and drive live React Native apps: logs, network, screenshots, UI automation, and fiber-tree inspection.

24 AI-callable tools for API mocking, chaos engineering, security scanning, SSL checks, CORS debugging, OpenAPI validation, JWT decoding, HAR analysis, distributed tracing, webhook capture, automation workflows, and uptime monitoring. Supports OAuth2 and Bearer token auth.

A manager server for MCP servers that handles process management and tool routing.

A Windows and MacOS app to manage local and remote MCP servers from a single interface with secure access control and logging.

A CLI tool to synchronize MCP (Model Context Protocol) settings across multiple AI coding tools.