It Tools MCP

🚀 IT Tools MCP Server

IT Tools MCP Server 是一個全面的模型上下文協議（MCP）服務器，為開發者、系統管理員和 IT 專業人員提供了 112 種常用的 IT 工具和實用程序，可滿足編碼、文本處理、網絡操作等多種開發與 IT 任務需求。

🚀 快速開始

此 MCP 服務器為開發者、系統管理員和 IT 專業人員提供了 112 種常用 IT 工具和實用程序的訪問途徑，涵蓋編碼/解碼、文本處理、哈希、網絡實用程序等常見開發和 IT 任務的完整工具集。

✨ 主要特性

• 工具豐富：提供 112 種工具，涵蓋 14 個類別，滿足多樣化的開發和 IT 任務需求。
• 多方式集成：支持在 VS Code 中使用，可通過 Node 或 Docker 部署。
• AI 輔助開發：藉助多種 AI 工具進行開發，保證代碼質量和開發效率。
• 易於擴展：方便添加新工具，遵循一定規範即可快速集成。

📦 安裝指南

在 VS Code 中使用

將以下內容添加到 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"
        ]
      }
  }
}

交互式模式

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

編程式使用

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

# 將文本編碼為 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

💻 使用示例

基礎用法

# 生成 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":3,"method":"tools/call","params":{"name":"random-port","arguments":{"count":3,"min":1024,"max":65535}}}' | \
  docker run -i --rm wrenchpilot/it-tools-mcp:latest

🛠️ 工具類別

此 MCP 服務器提供涵蓋 14 個類別的 112 種工具：

• Ansible 工具 (5 種工具)：Vault 加密/解密、清單解析器、劇本驗證器、參考資料
• 顏色工具 (2 種工具)：十六進制 ↔ RGB 轉換
• 數據格式 (12 種工具)：JSON、XML、YAML、SQL、TOML、Markdown ↔ HTML 轉換、電話號碼格式化
• 開發工具 (6 種工具)：正則表達式測試、cron 表達式生成、列表轉換、代碼美化器、Markdown 目錄生成
• Docker 工具 (5 種工具)：Compose 驗證、轉換工具、Traefik 生成器、參考資料
• 編碼與解碼 (8 種工具)：Base64、URL、HTML 實體、文本轉二進制
• 取證工具 (3 種工具)：文件類型識別、Microsoft SafeLinks 解碼、URL 清理與還原
• ID 與代碼生成器 (4 種工具)：UUID、ULID、二維碼、SVG 佔位符
• 數學與計算 (6 種工具)：表達式求值、進制轉換、溫度、百分比、Unix 時間戳、羅馬數字
• 網絡與系統 (23 種工具)：IPv4/IPv6 子網、URL 解析、MAC 地址、ps、top、cat、head、tail、grep、ping、nslookup、telnet、dig、ssh、scp、curl、IBAN 驗證
• 物理 (3 種工具)：角度、能量和功率單位轉換
• 安全與加密 (12 種工具)：哈希 (MD5、SHA1、SHA256、SHA512)、HMAC、JWT、bcrypt、密碼、令牌、OTP、BIP39
• 文本處理 (19 種工具)：大小寫轉換、統計、差異比較、ASCII 藝術字、北約音標字母表、URL 友好化、Unicode
• 實用工具 (7 種工具)：電子郵件規範化、MIME 類型、HTTP 狀態碼、設備信息、CSS 美化器、REM/PX 單位轉換

📸 截圖示例

密碼哈希生成示例

ASCII 藝術字生成示例

這些示例展示瞭如何在 VS Code Copilot Chat 中使用 IT Tools MCP 服務器進行安全密碼哈希生成和創意 ASCII 藝術字生成。

📚 詳細文檔

可用工具

🔧 技術細節

架構與開發

使用 TypeScript、Zod 驗證和 MCP SDK 構建，確保操作的健壯性和類型安全性。

AI 輔助開發

本項目使用 VS Code、Copilot Chat Agent、Playwright MCP 和 Claude Sonnet 4 模型 進行開發，展示了 AI 輔助軟件開發的強大功能：

• 智能代碼生成：Claude Sonnet 分析需求並生成全面的工具實現。
• 模式驗證：自動識別並解決 112 種工具中的 JSON 模式驗證問題。
• Docker 優化：創建生產就緒的 Docker 工作流和多階段構建。
• 文檔生成：生成包含示例和工具參考表的全面 README。
• 測試：在整個代碼庫中實現強大的錯誤處理和驗證。

AI 的關鍵貢獻：

• 🔧 工具實現：所有 112 種工具均在 AI 輔助下設計和實現。
• 📦 Docker 設置：通過 GitHub Actions CI/CD 管道完成完整的容器化。
• 🔍 模式清理：系統地從所有工具定義中移除不支持的 Zod 關鍵字。
• 📚 文檔：包含使用示例和工具目錄的全面 README。
• 🚀 生產就緒：發佈到 Docker Hub，添加徽章並進行專業部署設置。

添加新工具

1. 在 src/tools/ 下的適當類別中創建工具目錄。
2. 在其 index.ts 中使用 Zod 定義工具的輸入模式。
3. 導出註冊函數以實現動態加載。
4. 使用 npm run build 重新構建。

項目結構

src/
├── index.ts              # 主 MCP 服務器，支持動態工具加載
└── tools/                # 模塊化工具類別
    ├── ansible/          # 5 種 Ansible 自動化工具
    ├── color/            # 2 種顏色轉換工具
    ├── crypto/           # 9 種加密和安全工具
    ├── dataFormat/       # 12 種數據格式轉換工具
    ├── development/      # 6 種開發實用工具
    ├── docker/           # 5 種 Docker 和容器化工具
    ├── encoding/         # 8 種編碼/解碼工具
    ├── forensic/         # 3 種數字取證工具
    ├── idGenerators/     # 4 種 ID 和代碼生成工具
    ├── math/             # 6 種數學運算工具
    ├── network/          # 23 種網絡實用工具
    ├── physics/          # 3 種物理計算工具
    ├── text/             # 19 種文本處理工具
    └── utility/          # 7 種通用實用工具

🤝 貢獻指南

歡迎貢獻代碼！請遵循以下指南：

提交消息格式

本項目使用 Conventional Commits 來確保提交消息清晰一致。

版本管理：

• 🤖 自動版本升級 - Git 鉤子根據提交消息類型自動升級版本。
• 🤖 自動發佈 - CI/CD 檢測到更改後自動發佈。
• 🏷️ Git 標籤 - 根據常規提交消息自動創建。

示例：

git commit -m "feat: add new encryption tool"    # → 次要版本升級
git commit -m "fix: resolve base64 decoding issue"  # → 補丁版本升級
git commit -m "docs: improve README examples"   # → 補丁版本升級
git commit -m "feat!: breaking API change"      # → 主要版本升級

# 版本由 git 鉤子自動升級並提交
# 無需手動執行 npm version 命令！
git push

📖 有關設置說明，請參閱 COMMIT_TEMPLATE_SETUP.md。

開發流程

1. 分叉倉庫。
2. 運行 ./setup-commit-template.sh (推薦)。
3. 創建功能分支。
4. 根據項目結構進行更改。
5. 使用常規提交消息。
6. 提交拉取請求。

CI/CD 管道將自動執行以下操作：

• ✅ 構建並測試更改。
• 🏷️ 根據提交消息升級版本 (合併到主分支時)。
• 📦 發佈到 Docker Hub 和 NPM。
• 🚀 創建 GitHub 版本。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

🔗 相關項目

受 IT Tools 啟發 - 面向開發者的在線工具。

本項目整合了 @sharevb fork 中的部分工具，該分支擴展了 IT Tools 並增加了額外的實用程序和增強功能。