It Tools MCP

🚀 IT Tools MCP Server

このプロジェクトは、包括的なModel Context Protocol (MCP)サーバーです。開発者、システム管理者、ITプロフェッショナルが一般的に使用する112のITツールとユーティリティにアクセスできます。エンコード/デコード、テキスト操作、ハッシュ、ネットワークユーティリティなど、多くの一般的な開発およびITタスクに必要なツール一式を提供します。

🚀 クイックスタート

このサーバーを使用することで、多様なITツールを手軽に利用できます。以下にインストール方法や使用例を示します。

✨ 主な機能

• 多様なツールカテゴリ：14のカテゴリにまたがる112のツールを提供します。
• AI支援開発：AIを活用して開発され、コード品質やテストの充実が図られています。
• 柔軟なインストール方法：VS Code、Dockerなどを通じて簡単にインストールできます。

📦 インストール

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

高度な使用法

# 複数のツールを連携した高度な操作例
# まずテキストをBase64エンコードし、その結果をハッシュ化する
encoded_text=$(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)
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"hash-sha256","arguments":{"text":'"$encoded_text"'"}}}' | \
  docker run -i --rm wrenchpilot/it-tools-mcp:latest

📚 ドキュメント

ツールカテゴリ

このMCPサーバーは、14のカテゴリにまたがる112のツールを提供します。

• Ansible Tools (5つのツール): Vaultの暗号化/復号化、インベントリパーサー、プレイブックバリデーター、リファレンス
• Color Tools (2つのツール): 16進数とRGBの変換
• Data Format (12のツール): JSON、XML、YAML、SQL、TOML、MarkdownとHTMLの変換、電話番号の整形
• Development Tools (6つのツール): 正規表現のテスト、クロン式の生成、リストの変換、コードの整形、Markdownの目次生成
• Docker Tools (5つのツール): Composeの検証、変換ツール、Traefikジェネレーター、リファレンス
• Encoding & Decoding (8つのツール): Base64、URL、HTMLエンティティ、テキストとバイナリの変換
• Forensic Tools (3つのツール): ファイルタイプの識別、Microsoft SafeLinksの復号化、URLのファング化/デファング化
• ID & Code Generators (4つのツール): UUID、ULID、QRコード、SVGプレースホルダーの生成
• Math & Calculations (6つのツール): 式の評価、基数変換、温度、パーセンテージ、Unixタイムスタンプ、ローマ数字の変換
• Network & System (23のツール): IPv4/IPv6サブネット、URLの解析、MACアドレス、ps、top、cat、head、tail、grep、ping、nslookup、telnet、dig、ssh、scp、curl、IBANの検証
• Physics (3つのツール): 角度、エネルギー、電力の単位変換
• Security & Crypto (12のツール): ハッシュ化 (MD5、SHA1、SHA256、SHA512)、HMAC、JWT、bcrypt、パスワード、トークン、OTP、BIP39
• Text Processing (19のツール): ケース変換、統計情報、差分、ASCIIアート、NATOアルファベット、スラッグ化、Unicodeの操作
• Utility Tools (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 Modelを使用して開発されており、AI支援によるソフトウェア開発の威力を実証しています。

• インテリジェントなコード生成：Claude Sonnetが要件を分析し、包括的なツールの実装を生成しました。
• スキーマバリデーション：自動的に112のツール全体でJSONスキーマのバリデーション問題を特定し、解決しました。
• Docker最適化：本番環境で使用可能なDockerワークフローとマルチステージビルドを作成しました。
• ドキュメント：包括的なREADMEと使用例、ツールリファレンステーブルを生成しました。
• テスト：コードベース全体に堅牢なエラーハンドリングとバリデーションを実装しました。

AIの主要な貢献：

• 🔧 ツールの実装：すべての112のツールがAIの支援を受けて設計および実装されました。
• 📦 Dockerセットアップ：GitHub Actions CI/CDパイプラインを使用した完全なコンテナ化。
• 🔍 スキーマのクリーンアップ：すべてのツール定義からサポートされていないZodキーワードを体系的に削除しました。
• 📚 ドキュメント：使用例とツールカタログを含む包括的なREADME。
• 🚀 本番環境対応：Docker Hubへの公開、バッジ、プロフェッショナルなデプロイ設定。

これは、AIがコード品質、適切なアーキテクチャ、包括的なテストを維持しながら開発を加速できることを示しています。

新しいツールの追加

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パイプラインは自動的に以下を行います。

• ✅ 変更をビルドし、テストします。
• 🏷️ コミットメッセージに基づいてバージョンをアップします (mainブランチにマージされたとき)。
• 📦 Docker HubとNPMに公開します。
• 🚀 GitHubリリースを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEを参照してください。

🔗 関連リンク

このプロジェクトは、IT Toolsにインスパイアされています。これは開発者向けのオンラインツールです。

また、このプロジェクトは@sharevb forkから選択されたツールを組み込んでおり、追加のユーティリティと機能強化が行われています。