MCP Watch 🔍

MCP Watch 🔍

MCP の実装における脆弱性やセキュリティ上の問題を検出する、Model Context Protocol（MCP）サーバー向けの包括的なセキュリティスキャナーです。

機能

• 🔑 認証情報の検出 - ハードコードされた API キーやトークン、安全でない認証情報の保存を検出します
• 🧪 ツールポイズニング - ツールの説明に隠された悪意のある指示を検出します
• 🎯 パラメーターインジェクション - 機密性の高い AI コンテキストを抽出するマジックパラメーターを特定します
• 💉 プロンプトインジェクション - プロンプトの操作やインジェクション攻撃をスキャンします
• 🔄 ツールの変更 - 動的なツールの変更やラグプルのリスクを検出します
• 💬 会話の流出 - 会話履歴を盗み出すトリガーを検出します
• 🎨 ANSI インジェクション - エスケープシーケンスを使ったステガノグラフィー攻撃を検出します
• 📋 プロトコル違反 - MCP プロトコルのセキュリティ違反を特定します
• 🛡️ 入力検証 - コマンドインジェクション、SSRF、パストラバーサルの問題を検出します
• 🎭 サーバーの偽装 - 人気サービスになりすましたサーバーを検出します
• 🌊 有害なデータフロー - 危険なデータフローパターンを特定します
• 🔐 権限の問題 - 過剰な権限やアクセス制御の問題を検出します

クイックスタート 🚀

オプション 1：NPM パッケージ（推奨）

# Install globally
npm install -g mcp-watch

# Scan any GitHub MCP repository
mcp-watch scan https://github.com/user/mcp-server

# Scan your local MCP project
mcp-watch scan-local /path/to/your/mcp-project

オプション 2：GitHub ソースから

# Clone and use immediately
git clone https://github.com/kapilduraphe/mcp-watch.git
cd mcp-watch
npm install
npm run build

# Scan GitHub repos
npm run scan:github https://github.com/user/mcp-server

# Scan local projects  
npm run scan:local /path/to/your/mcp-project

オプション 3：Docker（インストール不要）

# Scan without installing anything
docker run --rm mcp-watch scan https://github.com/user/mcp-server
docker run --rm -v $(pwd):/workspace mcp-watch scan-local /workspace

インストール

グローバルインストール

npm install -g mcp-watch

ローカルインストール

npm install mcp-watch

ソースから

git clone https://github.com/kapilduraphe/mcp-watch.git
cd mcp-watch
npm install
npm run build

Docker のインストール 🐳

Docker でクイックスタート

# Build and run locally
docker build -t mcp-watch .
docker run --rm mcp-watch scan https://github.com/user/mcp-server

# Build from source
git clone https://github.com/kapilduraphe/mcp-watch.git
cd mcp-watch
docker build -t mcp-watch .

Docker Compose（本番環境に推奨）

# Build and run with Docker Compose
docker compose build
docker compose up mcp-watch

# Or run a one-off scan
docker compose run --rm mcp-watch scan https://github.com/user/repo

Docker の機能

• 🔒 セキュリティ：非 root ユーザー、最小限の攻撃対象領域
• 📦 最適化：マルチステージビルド、Alpine Linux ベース
• 🚀 本番環境対応：デプロイと CI/CD に対応
• 🧹 シンプル：あらゆる用途に対応する、最適化された単一の Dockerfile

使用方法

コマンドライン

GitHub リポジトリをスキャン

# Scan a GitHub repository
mcp-watch scan https://github.com/user/mcp-server

# Scan with JSON output
mcp-watch scan https://github.com/user/mcp-server --format json

# Filter by severity
mcp-watch scan https://github.com/user/mcp-server --severity high

# Filter by category
mcp-watch scan https://github.com/user/mcp-server --category credential-leak

ローカルプロジェクトをスキャン

# Scan current directory
mcp-watch scan-local .

# Scan specific directory (absolute path)
mcp-watch scan-local /path/to/your/mcp-project

# Scan specific directory (relative path)
mcp-watch scan-local ../my-mcp-server

# Local scan with JSON output
mcp-watch scan-local . --format json

# Local scan with severity filter
mcp-watch scan-local . --severity high

インストール方法別の使用方法

NPM パッケージから

# Global installation (recommended)
npm install -g mcp-watch
mcp-watch scan https://github.com/user/mcp-server
mcp-watch scan-local /path/to/project

GitHub ソースから

# Clone and build
git clone https://github.com/kapilduraphe/mcp-watch.git
cd mcp-watch
npm install
npm run build

# Use built version
node dist/main.js scan https://github.com/user/mcp-server
node dist/main.js scan-local /path/to/project

# Or use npm scripts
npm run scan https://github.com/user/mcp-server
npm run scan-local /path/to/project

Docker の使用方法 🐳

# Production container
docker run --rm mcp-watch scan https://github.com/user/mcp-server
docker run --rm mcp-watch scan https://github.com/user/mcp-server --format json --severity high

# Docker Compose
docker compose run --rm mcp-watch scan https://github.com/user/repo
docker compose run --rm mcp-watch scan https://github.com/user/repo --format json

# Interactive container
docker run -it --rm mcp-watch sh

オプション

• --format <type> - 出力形式：console（デフォルト）または json
• --severity <level> - 最小重大度：low、medium、high、critical
• --category <cat> - 脆弱性カテゴリでフィルター

カテゴリ

• credential-leak - ハードコードされた認証情報と安全でない保存
• tool-poisoning - 悪意のあるツールの説明
• data-exfiltration - データ窃取とパラメーターインジェクション
• prompt-injection - プロンプト操作攻撃
• tool-mutation - 動的なツールの変更
• steganographic-attack - エスケープシーケンスに隠されたコンテンツ
• protocol-violation - MCP プロトコルのセキュリティ上の問題
• input-validation - コマンドインジェクション、SSRF、パストラバーサル
• server-spoofing - サーバーの偽装
• toxic-flow - 危険なデータフロー
• access-control - 権限とアクセスの問題

出力例

🔍 Scanning repository: https://github.com/user/mcp-server
📊 Based on vulnerablemcp.info, HiddenLayer, Invariant Labs, and Trail of Bits research

🔑 Scanning for credential vulnerabilities...
🧪 Scanning for tool poisoning vulnerabilities...
🎯 Scanning for parameter injection vulnerabilities...
💉 Scanning for prompt injection vulnerabilities...

📊 MCP SECURITY SCAN RESULTS
===============================

📈 Summary by Severity:
  🚨 CRITICAL: 2
  ⚠️ HIGH: 1
  ⚡ MEDIUM: 3

🔍 Detailed Results:
--------------------

1. 🚨 Hardcoded credentials detected
   📋 ID: HARDCODED_CREDENTIALS
   🎯 Severity: CRITICAL
   📂 Category: credential-leak
   📍 Location: src/config.ts:15
   🔍 Evidence: const apiKey = "sk-***REDACTED***"

開発

プロジェクト構成

mcp-watch/
├── main.ts                          # CLI entry point
├── types/
│   └── Vulnerability.ts             # Type definitions
├── scanner/
│   ├── MCPScanner.ts               # Main scanner orchestrator
│   ├── BaseScanner.ts              # Base scanner utilities
│   └── scanners/                   # Individual vulnerability scanners
│       ├── CredentialScanner.ts
│       ├── ParameterInjectionScanner.ts
│       └── ...
├── utils/
│   └── reportFormatter.ts          # Report formatting
└── Docker/                          # Containerization
    ├── Dockerfile                   # Production image
    ├── docker-compose.yml           # Multi-service orchestration (Docker Compose v2)
    └── .dockerignore                # Build optimization

開発用スクリプト

# Build the project
npm run build

# Run in development mode
npm run dev scan https://github.com/user/repo

# Quick scan during development
npm run scan https://github.com/user/repo

# Clean build artifacts
npm run clean

# Type checking
npm run type-check

開発ワークフロー 🚀

ローカル開発（推奨）

# Install dependencies
npm install

# Run development server
npm run dev

# Run scans during development
npm run scan https://github.com/user/repo

# Type checking
npm run type-check

Docker 開発 🐳

# Build Docker image
docker compose build

# Test the image
docker run --rm mcp-watch scan https://github.com/user/repo

# Test Docker Compose
docker compose run --rm mcp-watch scan --help

新しいスキャナーの追加

1. scanner/scanners/ に新しいスキャナーを作成します
2. AbstractScanner を拡張します
3. scan() メソッドを実装します
4. MCPScanner.ts に追加します

例：

import { AbstractScanner } from "../BaseScanner";
import { Vulnerability } from "../../types/Vulnerability";

export class MyScanner extends AbstractScanner {
  async scan(projectPath: string): Promise<Vulnerability[]> {
    console.log("🔍 Scanning for my vulnerability type...");
    
    const vulnerabilities: Vulnerability[] = [];
    // Your scanning logic here
    
    return vulnerabilities;
  }
}

セキュリティ研究

このツールは、AI とサイバーセキュリティ分野をリードする組織のセキュリティ研究に基づいており、MCP 環境に特有の新たな攻撃ベクトルを特定します。その内容は以下のとおりです。

• 機密性の高い AI コンテキストを抽出するパラメーターインジェクション攻撃
• 隠された悪意のある指示を使ったツールポイズニング
• トリガーフレーズを使った会話の流出
• ANSI エスケープシーケンスを介したステガノグラフィー攻撃
• リポジトリの境界を越える有害なエージェントフロー

調査資料

• VulnerableMCP Database (vulnerablemcp.info)

  • MCP の脆弱性を網羅したデータベース
  • 実際の攻撃パターンと事例
  • 新たな攻撃ベクトルに関する定期的な更新

• HiddenLayer Research (MCP ツールのパラメーターを悪用する)

  • 機密データを抽出するパラメーターインジェクション攻撃
  • ツール呼び出し履歴と会話の窃取
  • システムプロンプト抽出の脆弱性
  • 思考の連鎖の操作
  • モデル名の開示リスク

• Invariant Labs Research (GitHub MCP の脆弱性)

  • ツールポイズニングの検出
  • 有害なエージェントフロー
  • リポジトリ間のセキュリティ問題
  • ツール機能のロールバック更新
  • サーバーなりすましの防止

• Trail of Bits Research (MCP セキュリティ調査)

  • 会話の窃取手法
  • ANSI インジェクション攻撃
  • プロトコルレベルの脆弱性
  • 安全でない認証情報の保存パターン
  • サーバー間のシャドーイング攻撃

• PromptHub Analysis (MCP のセキュリティ脆弱性 5 件)

  • コマンドインジェクションのパターン（公開されている MCP サーバーの 43% が影響を受けます）
  • SSRF の脆弱性に関する統計（30% が任意の URL の取得を許可しています）
  • パストラバーサル攻撃ベクトル（22% が意図されたディレクトリの外部にあるファイルを漏えいします）
  • Retrieval-Agent Deception（RADE）攻撃
  • ツールポイズニングの防止策

終了コード

• 0 - 重大または高深刻度の脆弱性は見つかりませんでした
• 1 - 重大または高深刻度の脆弱性が検出されました
• 1 - スキャンエラーが発生しました

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. npm run type-check で型チェックを実行します
4. 変更を手動でテストします
5. プルリクエストを送信します

GitHub Actions 🚀

このリポジトリでは、CI/CD、セキュリティスキャン、依存関係の管理に自動化されたワークフローを使用しています。

• CI：プッシュまたは PR ごとに自動テストと Docker の検証を実行
• セキュリティスキャン：毎日のセキュリティ監査と脆弱性チェック
• 依存関係の更新：毎週の依存関係メンテナンスとセキュリティ修正
• リリース：リリースアセットの自動作成
• Docker テスト：Docker 固有のテストと検証

Dependabot 🤖

以下を使用した依存関係の自動管理：

• npm：毎週更新し、マイナー／パッチバージョンは自動マージ
• GitHub Actions：アクションの自動更新
• Docker：ベースイメージの更新

ワークフローの詳細については、GITHUB_ACTIONS.md を参照してください。

Docker 開発ワークフロー 🐳

# Clone and setup
git clone https://github.com/kapilduraphe/mcp-watch.git
cd mcp-watch

# Build Docker image
docker compose build

# Test the image
docker run --rm mcp-watch --help

# Run a scan
docker compose run --rm mcp-watch scan https://github.com/user/repo

ライセンス

MIT License — 詳細については LICENSE ファイルを参照してください。

サポート

• バグ報告や機能リクエストは、イシューを作成してください
• 新しいイシューを作成する前に、既存のイシューを確認してください
• イシューを報告する際は、スキャン出力とリポジトリの詳細を含めてください

Docker のサポート 🐳

• ドキュメント：DOCKER.md で Docker の詳しい使用方法を確認してください
• イシュー：イシューを報告する際は、Docker のバージョンと Docker Compose のバージョンを含めてください
• テスト：本番用コンテナと開発用コンテナの両方でテストしてください

---

⚠️ セキュリティに関する注意：このツールは潜在的なセキュリティ問題を特定しますが、唯一のセキュリティ対策として使用すべきではありません。必ず手動でセキュリティレビューを実施し、セキュリティのベストプラクティスに従ってください。