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 并增加了额外的实用程序和增强功能。