Online Cyber Tools Mcp

onlinecybertools-mcp-server

AI エージェント（Claude Code、Codex、Cursor、Continue など）が Online Cyber Tools カタログをネイティブな MCP ツールとして利用できるようにする MCP（Model Context Protocol）サーバーです。

提供する機能

• ドキュメント化された MCP 互換の /api/tools/{category}/{tool} 操作ごとに 1 つの MCP ツールを提供します。POST ツールは JSON リクエスト本文のスキーマを使用し、互換性のある GET ツールは OpenAPI のクエリ／パスパラメーターを使用します。スキーマはサイトの OpenAPI 3.1 仕様 /api/openapi.json から直接取得するため、エージェントはツールごとの引数検証を利用できます。仕様で宣言されている場合、ツールには MCP の annotations（title と readOnlyHint / destructiveHint / idempotentHint。x-mcp-annotations から取得）と outputSchema（インラインの 200 レスポンスオブジェクトスキーマ）も含まれます。
• 人間が使うものと同じキーワード検索を行う search メタツールを提供します。 GET /api/tools/search?q=... を使用します。
• GET /api/mcp/tool-docs/{tool_id} から詳細なページの説明、ソースリンク、ページ URL、API エンドポイント、SEO 説明を取得する describe_tool メタツールを提供します。ping のようなメニュー ID と、network_ping のような MCP ツール名のどちらも指定できます。
• POST /api/agent/bug-report に対して構造化されたバグレポートを送信する report_bug メタツールを提供します（厳格なレート制限があります）。

呼び出しは稼働中の HTTP API にプロキシされます。このサーバー内でアルゴリズムを再実装することはありません。 これにより、エージェントはデプロイ済みサイトの動作をそのまま利用できます。 生成されるツールの説明には、操作の OpenAPI summary と description のみが含まれます。それ以外は含まれません。呼び出し元エージェントにとってノイズとなるメニュー ID の接頭辞や describe_tool への参照もありません。 describe_tool メタツールは、必要に応じてページの詳細な説明を取得したいエージェント向けに引き続き利用できます。

ツール

このサーバーは、15 カテゴリーにわたる 279 個のツールを提供します： エンコード／デコード、バイナリー／テキスト変換、暗号化とハッシュ、Web 開発ユーティリティ、テキストユーティリティ、OSINT ツール、ネットワークツール、セキュリティツール、SEO ツール、Linux ツール、日付と時刻、数学と計算機、データツール、ファイルツール、リバースエンジニアリング。

• 全リスト（このリポジトリ）： TOOLS.md — カテゴリー別にまとめたすべてのツール。
• ライブカタログ： https://onlinecybertools.com/#browse-the-full-inventory
• 機械可読な仕様： https://onlinecybertools.com/api/openapi.json
• ツールを選んで設定を作成： https://onlinecybertools.com/integrations/mcp-plugin-builder

このセクションと TOOLS.md は、リリースごとに稼働中のメニューから自動生成されます。そのため、件数や一覧が食い違うことはありません。

クイックスタート

このパッケージは npm で onlinecybertools-mcp-server として公開されているため、どの MCP クライアントからでも npx -y onlinecybertools-mcp-server で起動できます。リポジトリのクローンも、グローバルインストールも不要です。以下の設定例はそのまま使用でき、デフォルトで全ツールカタログを利用できます。

セットアップをガイドに沿って進めたい場合は、Web サイトのインタラクティブなビルダーから、すぐに使える Claude Code プラグインまたは Codex 設定ブロックを生成できます。

https://onlinecybertools.com/integrations/mcp-plugin-builder

ビルダーではツールの一部を選択でき、それに対応する OCTOOLS_TOOLS フィルターが自動生成されます（設定を参照）。

設定

環境変数で設定します。すべて任意です。

変数	デフォルト	目的
OCTOOLS_BASE_URL	https://onlinecybertools.com	リクエストのプロキシ先サイトです。
OCTOOLS_TOOLS	(未設定 → すべてのツール)	公開する範囲を制限する、カンマ区切りのメニュー ID（base64_encode,sha256,hash）です。すべてのツールを公開するには未設定のままにしてください — 以下の例では意図的に省略しています。
OCTOOLS_STREAM_BYTE_CAP	262144 (256 KiB)	ストリーミング（x-mcp-compatible: stream-buffered）エンドポイントから蓄積する最大バイト数です。
OCTOOLS_STREAM_TIME_CAP_MS	30000 (30 s)	ストリーミングエンドポイントのバッファリングに費やす最大実時間です。

OCTOOLS_TOOLS が設定されている場合、サーバーは仕様の取得リクエストに ?tools=... を追加し、サイトから事前にフィルタリングされた仕様を取得します。さらに、クライアント側でも多層防御としてフィルターを適用します。

実行

Inspector（手動スモークテスト）

npx @modelcontextprotocol/inspector npx -y onlinecybertools-mcp-server

Inspector の URL を開き、List Tools をクリックすると、search、describe_tool、report_bug に加えて、互換性のある Symfony API 操作ごとに 1 つのエントリが表示されます。OCTOOLS_TOOLS を設定しない場合は、カタログ全体が表示されます。

代わりにサーバーをローカルで開発するには、クローンしてソースから実行します。

git clone https://github.com/Jambozx/onlinecybertools-mcp-server.git
cd onlinecybertools-mcp-server
npm install
npx @modelcontextprotocol/inspector node index.mjs

Claude Code

~/.claude.json（またはプロジェクトの .mcp.json）に追加します。

{
  "mcpServers": {
    "octools": {
      "command": "npx",
      "args": ["-y", "onlinecybertools-mcp-server"]
    }
  }
}

すべてのツールが公開されます。公開範囲を制限するには、OCTOOLS_TOOLS を含む env ブロックを追加します。

{
  "mcpServers": {
    "octools": {
      "command": "npx",
      "args": ["-y", "onlinecybertools-mcp-server"],
      "env": {
        "OCTOOLS_TOOLS": "base64_encode,sha256,hash"
      }
    }
  }
}

Codex

~/.codex/config.toml に追加します。

[mcp_servers.octools]
command = "npx"
args = ["-y", "onlinecybertools-mcp-server"]

公開範囲を制限するには、OCTOOLS_TOOLS を含む env 行を追加します。

[mcp_servers.octools]
command = "npx"
args = ["-y", "onlinecybertools-mcp-server"]
env = { OCTOOLS_TOOLS = "base64_encode,sha256,hash" }

Cursor / Continue / 汎用 MCP クライアント

ほとんどのクライアントは、同じ command/args/env の形式に対応しています。npx -y onlinecybertools-mcp-server を使って、このパッケージを指定してください。

ストリーミングエンドポイント

仕様で x-mcp-compatible: stream-buffered タグが付いたエンドポイント（現在は traceroute および proxy-test のストリーム）は、最後まで読み込まれ、蓄積された SSE イベントを単一の JSON エンベロープとして返します。GET ストリームエンドポイントではツール引数をクエリパラメーターとして送信し、POST ストリームでは JSON ボディを送信します。上限は次のとおりです。

• バッファリングされる出力は 256 KiB（OCTOOLS_STREAM_BYTE_CAP）まで
• 実時間は 30 秒（OCTOOLS_STREAM_TIME_CAP_MS）まで

どちらかの上限に達すると、エージェントが出力の一部しか得られていないことを認識できるよう、レスポンスエンベロープに { "truncated": true } が含まれます。

x-mcp-compatible: none タグが付いたエンドポイント（マルチパートのファイルアップロードなど）は登録時にスキップされるため、tools/list には表示されません。

制限事項

• 仕様は起動時に 1 回だけ取得されます。サイトに新しいエンドポイントが追加された場合は、サーバーを再起動してください。
• stdio トランスポートのみ対応しています。HTTP サーバーはありません（特権エンドポイントの前段に認証を設ける必要を避けるため）。
• npm で onlinecybertools-mcp-server として公開されています（npx -y onlinecybertools-mcp-server）。GitHub から直接インストールする方法（npx -y github:Jambozx/onlinecybertools-mcp-server）も、最新の開発版で引き続き利用できます。

ライセンス

MIT。