Guardian MCP

Cursorの設定

CursorはネイティブでMCPをサポートしています。以下の手順に従って設定してください。

1. GuardianMCPをインストール

npm install -g guardian-mcp
# またはローカルインストールを使用する場合（クイックスタートを参照）

2. Cursorを設定

Cursorの設定を開きます。

• macOS/Linux：~/.cursor/config.json または Cursor Settings > Features > MCP Servers
• Windows：%APPDATA%\Cursor\config.json

GuardianMCPの設定を追加します。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "npx",
      "args": ["guardian-mcp"]
    }
  }
}

またはローカルインストールの場合

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/guardian-mcp/dist/index.js"]
    }
  }
}

3. 自動スキャンを有効にする（オプション）

プロジェクトに .cursor/rules.md を作成します。

# セキュリティルール
このプロジェクトで作業するとき：
- プロジェクト開始時にCRITICAL/HIGHの脆弱性をチェックする
- npm installまたはcomposer updateの後に自動的にスキャンする
- gitコミット前にCRITICALの問題があるかどうかを確認する

scan_mode="critical-high-only"でcheck_vulnerabilitiesツールを使用する。

4. Cursorを再起動

Cursorを完全に再起動して、GuardianMCPを読み込みます。

5. テストする

CursorのAIチャットを開き、以下を入力します。

Check my project for security vulnerabilities

GuardianMCPが自動的に依存関係をスキャンします！

VS Codeの設定

VS Codeは拡張機能または設定を通じてMCPサーバーを使用できます。

方法1: Continue.dev拡張機能を使用する

1. Continue.dev拡張機能をインストールします。
2. Continueの設定（.continue/config.json）を開きます。
3. MCPサーバーの設定を追加します。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "npx",
      "args": ["guardian-mcp"]
    }
  }
}

方法2: 直接設定する

1. GuardianMCPをインストールします：npm install -g guardian-mcp
2. VS Codeの設定（.vscode/settings.json）に追加します。

{
  "mcp.servers": {
    "guardian-mcp": {
      "command": "npx",
      "args": ["guardian-mcp"]
    }
  }
}

3. 自動スキャンを有効にする

.vscode/rules.md を作成します。

以下の場合に自動的に脆弱性をチェックする：
- プロジェクトを開くとき
- npm install/composer updateを実行した後
- コミットを作成する前

4. VS Codeを再起動

ウィンドウを再読み込みします：Cmd/Ctrl + Shift + P → "Reload Window"

Claude Desktopの設定

Claude DesktopはビルトインでMCPをサポートしています。

1. GuardianMCPをインストール

npm install -g guardian-mcp

2. Claude Desktopを設定

設定ファイルを開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

GuardianMCPを追加します。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "npx",
      "args": ["guardian-mcp"]
    }
  }
}

またはローカルインストールの場合

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "node",
      "args": ["/Users/you/path/to/guardian-mcp/dist/index.js"]
    }
  }
}

3. 自動スキャンを設定

~/.claude/rules.md（グローバル）またはプロジェクトの .claude/rules.md に追加します。

# GuardianMCPルール
以下の場合に自動的に脆弱性をスキャンする：
1. ユーザーが「security」、「vulnerability」、「CVE」、「audit」を言及したとき
2. パッケージをインストールした後
3. gitコミット前

自動スキャンにはscan_mode="critical-high-only"を使用する。

4. Claude Desktopを再起動

Claude Desktopを完全に終了して、再度開きます。

Windsurfの設定

WindsurfはCursorと同様にMCPサーバーをサポートしています。

1. GuardianMCPをインストール

npm install -g guardian-mcp

2. Windsurfを設定

Windsurfの設定を開きます。

• 場所：~/.windsurf/config.json

MCPサーバーを追加します。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "npx",
      "args": ["guardian-mcp"]
    }
  }
}

3. プロジェクトルールを作成

プロジェクトに .windsurf/rules.md を追加します。

以下の場合に依存関係の脆弱性を自動的にスキャンする：
- プロジェクトの初期化時
- npm/composerコマンドの実行後
- コミット前のチェック時

4. Windsurfを再起動

エディターを再読み込みして、GuardianMCPを有効にします。

Zedの設定

ZedはMCPサポートを追加中です。現在の状況を確認してください。

1. GuardianMCPをインストール

npm install -g guardian-mcp

2. Zedを設定

Zedの設定を開きます。

• macOS：~/.config/zed/settings.json
• Linux：~/.config/zed/settings.json

設定を追加します。

{
  "assistant": {
    "mcp_servers": {
      "guardian-mcp": {
        "command": "npx",
        "args": ["guardian-mcp"]
      }
    }
  }
}

3. Zedを再起動

エディターを再読み込みします。

注意：ZedのMCPサポートは実験的なものです。最新の状況については、Zedドキュメントを参照してください。

Dockerの設定

GuardianMCPをDockerコンテナで実行し、任意のIDEから接続できます。

方法1: Docker Composeを使用する（おすすめ）

1. リポジトリをクローンする

git clone https://github.com/Kalvisan/guardian-mcp.git
cd guardian-mcp

2. ビルドして実行する

docker-compose up -d

3. IDEを設定する IDEのMCP設定で、以下を使用します。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "guardian-mcp", "node", "dist/index.js"]
    }
  }
}

方法2: Docker Runを使用する

1. イメージをビルドする

docker build -t kalmars/guardian-mcp:latest .

2. コンテナを実行する

docker run -d --name guardian-mcp \
  -v /path/to/your/projects:/projects:ro \
  kalmars/guardian-mcp:latest

3. IDEを設定する

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "guardian-mcp", "node", "dist/index.js"]
    }
  }
}

CursorでDockerを使用する場合

~/.cursor/config.json を編集します。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "guardian-mcp", "node", "dist/index.js"]
    }
  }
}

ボリュームマウント

コンテナ外のプロジェクトをスキャンするには、以下のようにします。

docker run -d --name guardian-mcp \
  -v /Users/you/projects:/projects:ro \
  -v /Users/you/work:/work:ro \
  guardian-mcp:latest

その後、以下のようにスキャンします。

Scan /projects/my-app for vulnerabilities

Dockerヘルスチェック

docker ps --filter name=guardian-mcp
# 「healthy」ステータスが表示されるはず

コンテナを停止する

docker-compose down
# または
docker stop guardian-mcp && docker rm guardian-mcp

汎用的なMCP設定

Model Context Protocolをサポートする任意のIDEに対して、以下の手順で設定できます。

1. GuardianMCPをインストール

npm install -g guardian-mcp

2. IDEのMCP設定を見つける

一般的な場所は以下の通りです。

• ~/.config/[IDE_NAME]/config.json
• ~/.config/[IDE_NAME]/settings.json
• ~/.[IDE_NAME]/mcp.json

3. GuardianMCPを追加

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "npx",
      "args": ["guardian-mcp"]
    }
  }
}

または、完全なパスを指定する場合は以下のようにします。

{
  "mcpServers": {
    "guardian-mcp": {
      "command": "node",
      "args": ["/full/path/to/guardian-mcp/dist/index.js"]
    }
  }
}

4. 設定を確認する

IDEのAIアシスタントに以下を尋ねることでテストできます。

Use the check_vulnerabilities tool to scan my project

1. インストールを確認する

   npx guardian-mcp --version
   # または
   which guardian-mcp
   

2. 設定ファイルのパスが絶対パスであることを確認する

   • ❌ "args": ["dist/index.js"]
   • ✅ "args": ["/Users/you/guardian-mcp/dist/index.js"]

3. IDEを完全に再起動する（ウィンドウを再読み込みするだけではなく）

4. IDEのログを確認する

   • Cursor: 開発者ツールを開く（Help > Toggle Developer Tools）
   • VS Code: 出力パネル > 拡張機能ホスト
   • Claude Desktop: View > Developer > Toggle Developer Tools

5. 手動でテストする

   node /path/to/guardian-mcp/dist/index.js
   # クラッシュしないはず
   

1. ルールファイルが存在することを確認する

   cat .cursor/rules.md
   # または
   cat .claude/rules.md
   

2. ルールにツール名が記載されていることを確認する

   • check_vulnerabilities を参照する必要があります
   • 自動スキャンには scan_mode="critical-high-only" を使用する

3. キーワードでテストする

   • 「security」または「vulnerability」と言ってみます
   • 自動スキャンがトリガーされるはず

4. IDEがルールをサポートしていることを確認する

   • Cursor: ✅ ビルトインサポート
   • Claude Desktop: ✅ ビルトインサポート
   • VS Code: 拡張機能に依存します

1. ログを確認する

   docker logs guardian-mcp
   

2. ビルドが成功したことを確認する

   docker build -t kalmars/guardian-mcp:latest .
   

3. 手動でテストする

   docker run -it kalmars/guardian-mcp:latest
   

4. ヘルスチェックを行う

   docker ps --filter name=guardian-mcp
   # ステータスが「healthy」であるはず
   

1. インターネット接続を確認する

2. APIがアクセス可能であることを確認する

   curl https://api.osv.dev/v1/query
   

3. レート制限：OSV.devにはレート制限があります

   • 数分待ってから再試行します
   • スキャン頻度を減らします

4. ファイアウォール：外部へのHTTPS通信が許可されていることを確認します