it-tools-mcp

IT Tools MCP サーバー

警告

このプロジェクトは非推奨となり、メンテナンスも終了しています。

AI 支援開発と Model Context Protocol（MCP）を探求する学習演習として開発されました。今後、更新、バグ修正、プルリクエストの受け付けは行いません。このリポジトリは参考資料としてのみ保管されています。

IT ユーティリティを備えた、現在もメンテナンスされている MCP サーバーが必要な場合は、コミュニティによる代替プロジェクトをお探しください。

📝 注記：文字数制限のため、この README の短縮版は Docker Hub に自動的に同期されます。

開発者、システム管理者、IT 専門家が日常的に使用する 121 種類以上の IT ツールやユーティリティを利用できる、包括的な Model Context Protocol（MCP）サーバーです。エンコード／デコード、テキスト操作、ハッシュ化、ネットワークユーティリティなど、開発や IT でよく使われるさまざまなタスク向けのツール一式を提供します。

スターの履歴

📦 インストールとセットアップ

VS Code での使用

クイックインストール：

インストール：

1. VS Code を開きます
2. Ctrl+Shift+P（Mac では Cmd+Shift+P）を押します
3. 「MCP」と入力し、「MCP: Add Server」を選択します
4. 「NPM Package」を選択し、it-tools-mcp と入力します

または、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

プログラムからの使用

# 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

� MCP ロギング機能

このサーバーは、以下の機能を備えた MCP ロギングを完全にサポートしています：

ログレベル

• debug（0）：詳細なデバッグ情報
• info（1）：一般的な情報メッセージ
• notice（2）：通常の重要なイベント
• warning（3）：警告状態
• error（4）：エラー状態
• critical（5）：重大な状態
• alert（6）：直ちに対応が必要な状態
• emergency（7）：システムが使用不能な状態

ロギングツール

• logging_setLevel：実行時に最小ログレベルを変更します
• logging_status：現在のロギング設定と利用可能なレベルを確認します

環境に応じた動作

• 開発モード：デフォルトではデバッグレベルで、コンソール出力が強化されます
• 本番モード：デフォルトでは情報レベルで、MCP 準拠の簡潔な出力になります
• 自動フォールバック：MCP トランスポートの準備ができていない場合は、コンソールにログを出力します

使用例

# 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

🔧 MCP プロトコルユーティリティ

このサーバーは、高度なユーティリティを含む MCP 2025-06-18 仕様の全機能を実装しています。

Ping ユーティリティ

• ヘルスチェック：ping リクエストを使って接続状態を確認します
• 自動応答：MCP 仕様に従い、サーバーは空の結果を速やかに返します
• 接続監視：定期的なヘルスチェックを実装できます

進捗の追跡

• 長時間実行される操作：時間のかかるタスクの進捗状況を受け取ります
• 進捗トークン：進捗通知を有効にするには、リクエストに _meta.progressToken を含めます
• 通知：サーバーは現在の状態を含む notifications/progress を送信します

リクエストのキャンセル

• 正常なキャンセル：notifications/cancelled を送信して、処理中のリクエストを中止します
• リソースのクリーンアップ：リクエストがキャンセルされると、サーバーはリソースを適切に解放します
• 競合状態への対応：タイミングに関するエッジケースにも堅牢に対応します

サンプリングのサポート

• LLM 連携：サーバーは sampling/createMessage を使用して、クライアントに LLM の補完をリクエストできます
• モデルの優先設定：モデル選択のヒントと、コスト、速度、知能に関する機能の優先順位をサポートします
• コンテンツタイプ：サンプリングリクエストで、テキスト、画像、音声のコンテンツをサポートします
• エージェント型ワークフロー：ネストされた LLM 呼び出しによる、AI を活用したツール操作を可能にします
• クライアントの制御：モデルへのアクセスとユーザーの承認は、すべてクライアント側で制御されます

プロトコルの例

# 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

�🛠️ ツールのカテゴリ

この MCP サーバーは、14 カテゴリにわたって121 個以上のツールを提供します。

• � Ansible ツール（5 個のツール）：Vault の暗号化／復号、インベントリパーサー、プレイブックバリデーター、リファレンス
• 🎨 カラーツール（2 個のツール）：16 進数 ↔ RGB 変換
• 📝 データ形式（12 個のツール）：JSON、XML、YAML、SQL、TOML、Markdown ↔ HTML 変換、電話番号の書式設定
• �️ 開発ツール（6 個のツール）：正規表現テスト、cron 生成、リスト変換、コード整形、Markdown 目次
• 🐳 Docker ツール（5 個のツール）：Compose の検証、変換ツール、Traefik ジェネレーター、リファレンス
• 🔧 エンコードとデコード（8 個のツール）：Base64、URL、HTML エンティティ、テキストからバイナリへの変換
• 🔍 フォレンジックツール（3 個のツール）：ファイルタイプの特定、セーフリンクのデコード、URL ファンガー
• 🆔 ID とコードの生成ツール（4 個のツール：UUID、ULID、QR コード、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 アート、NATO アルファベット、スラッグ化、Unicode
• 🛠️ ユーティリティツール（7 個のツール）：メールアドレスの正規化、MIME タイプ、HTTP ステータスコード、デバイス情報、CSS 整形、rem／px 変換

📸 スクリーンショットの例

パスワードハッシュ生成の例

ASCII アートテキスト生成の例

セキュアなパスワードハッシュ化とクリエイティブな ASCII アート生成に、VS Code Copilot Chat と IT Tools MCP サーバーを使用する例です。

利用可能なツール

ツール	説明	パラメーター
Ansible ツール
parse_ansible_inventory	Ansible インベントリーを解析	inventory: string
generate_ansible_inventory	Ansible インベントリーを生成	hosts: string[], groups?: Record<string, string[]>, variables?: Record<string, any>
validate_ansible_playbook	Ansible プレイブックの YAML を検証	playbook: string
show_ansible_reference	Ansible の構文とモジュールのリファレンス	query?: string
decrypt_ansible_vault	Ansible Vault のデータを復号	data: string, password: string
encrypt_ansible_vault	Ansible Vault でデータを暗号化	data: string, password: string
カラー ツール
convert_hex_to_rgb	HEX を RGB に変換	hex: string
convert_rgb_to_hex	RGB を HEX に変換	r: number, g: number, b: number
データ形式
convert_html_to_markdown	HTML を Markdown に変換	html: string
compare_json	JSON オブジェクトを比較	json1: string, json2: string
format_json	JSON を整形して検証	json: string, indent?: number
minify_json	JSON を圧縮	json: string
convert_json_to_csv	JSON を CSV に変換	json: string, delimiter?: string
convert_json_to_toml	JSON を TOML に変換	json: string
convert_markdown_to_html	Markdown を HTML に変換	markdown: string
format_phone	電話番号を解析して整形	phoneNumber: string, countryCode?: string
format_sql	SQL を整形	sql: string, dialect?: 'sql' | 'mysql' | 'postgresql' | 'sqlite' | 'mariadb' | 'db2' | 'plsql' | 'n1ql' | 'redshift' | 'spark' | 'tsql' | 'trino' | 'bigquery' (optional, default: 'sql')
convert_toml_to_json	TOML を JSON に変換	toml: string
format_xml	XML を整形	xml: string, indent?: number
format_yaml	YAML を整形	yaml: string
開発ツール
generate_crontab	cron 式を生成	minute?: string, hour?: string, dayOfMonth?: string, month?: string, dayOfWeek?: string
format_html	HTML を整形して見やすくする	html: string, indent?: number
format_javascript	JavaScript を整形して見やすくする	javascript: string, indent?: number
convert_list	リスト形式を変換	list: string, inputFormat: 'comma' | 'semicolon' | 'newline' | 'space' | 'pipe', outputFormat: 'comma' | 'semicolon' | 'newline' | 'space' | 'pipe' | 'json' | 'quoted', trim?: boolean
generate_markdown_toc	Markdown の目次を生成	markdown: string, maxDepth?: number
test_regex	正規表現をテスト	pattern: string, text: string, flags?: string
Docker ツール
convert_docker_compose_to_run	Compose を Docker run コマンドに変換	compose: string, service?: string
validate_docker_compose	Docker Compose YAML を検証	compose: string
show_docker_reference	Docker コマンドと構文のリファレンス	query?: string
convert_docker_run_to_compose	Docker run を Compose に変換	command: string
generate_traefik_compose	Traefik Docker Compose を生成	domain: string, service: string, port?: number, network?: string
エンコードとデコード
decode_base64	Base64 テキストをデコード	text: string
encode_base64	テキストを Base64 にエンコード	text: string
decode_html	HTML エンティティをデコード	text: string
encode_html	HTML エンティティをエンコード	text: string
encode_html_entities	HTML エンティティの拡張エンコード／デコード	text: string, operation: 'encode' | 'decode'
convert_text_to_binary	テキストとバイナリーを相互変換	input: string, operation: 'encode' | 'decode'
convert_text_to_unicode	テキストと Unicode を相互変換	input: string, operation: 'encode' | 'decode'
decode_url	URL エンコードされたテキストをデコード	text: string
encode_url	URL エンコード	text: string
フォレンジックツール
identify_file_type	コンテンツからファイル形式を特定	data: string, filename?: string
decode_safelink	Microsoft SafeLinks をデコード	url: string
fang_url	分析用に URL を復元または無効化	text: string, operation: 'fang' | 'defang'
ID とコードの生成ツール
generate_qr_code	任意のコンテンツの QR コードを生成	text: string, size?: number - URL、WiFi（WIFI:T:WPA;S:network;P:password;;）、連絡先情報などに対応
generate_svg_placeholder	SVG プレースホルダーを生成	width?: number, height?: number, text?: string, backgroundColor?: string, textColor?: string
generate_ulid	ULID を生成	なし
generate_uuid	UUID v4 を生成	なし
数学と計算
evaluate_math	式を評価	expression: string
convert_number_base	数値の基数を変換	number: string, fromBase: number, toBase: number
calculate_percentage	パーセンテージを計算	operation: 'percentage-of' | 'what-percentage' | 'percentage-change', value1: number, value2: number
convert_roman_numerals	ローマ数字を変換	input: string
convert_temperature	温度を変換	temperature: number, from: 'celsius' | 'fahrenheit' | 'kelvin', to: 'celsius' | 'fahrenheit' | 'kelvin'
convert_unix_timestamp	タイムスタンプを変換	input: string
ネットワークとシステム
cat	ファイルの内容を表示	file: string
curl	HTTP クライアント（GET、POST など）	url: string, method?: string, headers?: Record<string, string>, body?: string
dig	DNS クエリ（カスタムタイプ）	target: string, type?: string
grep	ファイル内のパターンを検索	file: string, pattern: string
head	ファイルの先頭 N 行を表示	file: string, lines?: number
validate_iban	IBAN を検証	iban: string
calculate_ip_subnet	IPv4 サブネットを計算	ip: string, cidr: number
calculate_ipv4_subnet	IPv4 サブネットを拡張計算	cidr: string
generate_ipv6_ula	IPv6 ULA を生成	globalId?: string
generate_mac_address	MAC アドレスを生成	prefix?: string, separator?: ':' | '-'
nslookup	DNS ルックアップ（A／AAAA／CNAME）	target: string
ping	ホストに ping を実行	target: string, count?: number
ps	実行中のプロセスを一覧表示	なし
generate_random_port	ランダムなポートを生成	count?: number, min?: number, max?: number, exclude?: number[]
scp	リモートホストとの間でファイルをコピー（SFTP）	target: string, user: string, direction: 'upload'|'download', localPath: string, remotePath: string, privateKey?: string
ssh	SSH コマンドを実行	target: string, user: string, command: string
tail	ファイルの末尾 N 行を表示	file: string, lines?: number
telnet	TCP 接続をテスト	target: string, port: number
top	CPU 使用率順にプロセスを表示	なし
parse_url	URL の構成要素を解析	url: string
物理
convert_angle	角度の単位を変換	value: number, from: 'degrees' | 'radians' | 'gradians', to: 'degrees' | 'radians' | 'gradians'
convert_energy	エネルギーの単位を変換	value: number, from: 'joules' | 'calories' | 'kwh' | 'btu', to: 'joules' | 'calories' | 'kwh' | 'btu'
convert_power	電力の単位を変換	value: number, from: 'watts' | 'kilowatts' | 'horsepower' | 'btu_per_hour', to: 'watts' | 'kilowatts' | 'horsepower' | 'btu_per_hour'
セキュリティと暗号
generate_basic_auth	Basic Auth ヘッダーを生成	username: string, password: string
hash_bcrypt	bcrypt ハッシュを生成／検証	password: string, rounds?: number, hash?: string
generate_bip39	BIP39 ニーモニックを生成	wordCount?: '12' | '15' | '18' | '21' | '24'
hash_md5	MD5 ハッシュを生成	text: string
hash_sha1	SHA1 ハッシュを生成	text: string
hash_sha256	SHA256 ハッシュを生成	text: string
hash_sha512	SHA512 ハッシュを生成	text: string
generate_hmac	HMAC を生成	message: string, key: string, algorithm?: 'sha1' | 'sha256' | 'sha512'
decode_jwt	JWT トークンをデコード	token: string
generate_otp	TOTP コードを生成	secret: string, digits?: number, period?: number
generate_password	安全なパスワードを生成	length?: number, includeUppercase?: boolean, includeLowercase?: boolean, includeNumbers?: boolean, includeSymbols?: boolean
generate_token	安全なトークンを生成	length?: number, charset?: 'alphanumeric' | 'hex' | 'base64' | 'custom', customChars?: string
テキスト処理
generate_ascii_art	ASCII アートを生成	text: string, font?: string（295 種類以上の figlet フォントに対応）
analyze_distinct_words	テキストから重複しない単語を抽出	text: string, caseSensitive?: boolean
search_emoji	絵文字を検索	query: string
generate_lorem_ipsum	Lorem Ipsum を生成	type?: 'words' | 'sentences' | 'paragraphs', count?: number
generate_numeronym	数字略語を生成	text: string
slugify_text	URL スラッグに変換	text: string, separator?: string, lowercase?: boolean
obfuscate_string	テキストを難読化	text: string, method?: 'html-entities' | 'unicode' | 'base64'
convert_to_camelcase	camelCase に変換	text: string
capitalize_text	単語の先頭を大文字にする	text: string
compare_text	テキストを比較	text1: string, text2: string
convert_text_to_kebabcase	kebab-case に変換	text: string
convert_text_to_lowercase	小文字に変換	text: string
convert_text_to_pascalcase	PascalCase に変換	text: string
text_snakecase	snake_case に変換	text: string
analyze_text_stats	テキストの統計情報を取得	text: string
convert_text_to_nato	NATO フォネティック・アルファベットに変換	text: string
show_unicode_names	テキストを Unicode 文字名に変換	text: string
convert_text_to_uppercase	大文字に変換	text: string
ユーティリティツール
format_css	CSS を整形して見やすくする	css: string, indent?: number
show_device_info	システム情報を取得	なし
normalize_email	メールアドレスを正規化	email: string
lookup_http_status	HTTP ステータスのリファレンス	code?: number
lookup_mime_types	MIME タイプを検索	input: string, lookupType?: 'extension-to-mime' | 'mime-to-extension'
lookup_port_numbers	ポート番号の割り当てを検索	port?: number, service?: string
convert_rem_px	REM と PX の単位を相互変換	value: number, conversion: 'rem-to-px' | 'px-to-rem', baseFontSize?: number

🏗️ アーキテクチャと開発

堅牢で型安全な動作を実現するため、TypeScript、Zod によるバリデーション、MCP SDK を使用して構築されています。

🤖 AI 支援による開発

このプロジェクトは VS Code、Copilot Chat Agent、Playwright MCP、Claude Sonnet 4 Model を使用して開発され、AI 支援によるソフトウェア開発の力を示しています。

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

AI による主な貢献：

• 🔧 ツールの実装：すべてのツールを 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              # 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

🤝 コントリビューション

このプロジェクトでは、今後コントリビューションを受け付けません。 参考目的のみでアーカイブされています。以下のガイドラインは、歴史的な背景を示すために保持されています。

コミットメッセージの形式

このプロジェクトでは、明確で一貫性のあるコミットメッセージを記述するために Conventional Commits を使用しています。

バージョン管理：

• 🤖 バージョンの自動更新 - Git フックがコミットメッセージの種類に基づいてバージョンを自動的に更新します
• 🤖 公開の自動化 - CI/CD が変更を検出し、自動的に公開します
• 🏷️ Git タグ - Conventional Commits のコミットメッセージに基づいて自動的に作成されます

例：

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

📖 セットアップ手順については COMMIT_TEMPLATE_SETUP.md を参照してください。

開発プロセス

1. リポジトリをフォークします
2. ./setup-commit-template.sh を実行します（推奨）
3. フィーチャーブランチを作成します
4. プロジェクト構成に従って変更を加えます
5. Conventional Commits のコミットメッセージを使用します
6. プルリクエストを送信します

CI/CD パイプラインは、次の処理を自動的に行います。

• ✅ 変更をビルドしてテストします
• 🏷️ コミットメッセージに基づいてバージョンを更新します（main へのマージ時）
• 📦 Docker Hub と NPM に公開します
• 🚀 GitHub リリースを作成します

📄 ライセンス

MIT ライセンスです。詳細は LICENSE を参照してください。

🔗 関連プロジェクト

開発者向けオンラインツール IT Tools に着想を得ています。

このプロジェクトには、IT Tools を拡張してユーティリティと機能強化を追加する @sharevb fork の一部のツールが組み込まれています。