VA-MCP

開発段階の機能単位テストにおいて、OWASP TOP10に該当する脆弱性をチェックするためのMCPです。このMCPはAPIに関する情報を受け取り、分析してその分析結果を出力する予定です。

Scope (MVP)

• MCP stdioサーバーの実行

• 基本ツールの提供:

  • ping

  • list_supported_checks

• 今後のOWASP Top 10シナリオの拡張

Related MCP server: MCP-QA

事前準備 (Prerequisites)

チームメンバーが開発を開始する前に、以下がインストールされている必要があります。

• Git

• uv

• (推奨) Python 3.11+

インストール確認:

git --version
uv --version
python3 --version

Quick Start

# 1) 저장소 클론
git clone <repo-url>
cd VA-MCP

# 2) 의존성/가상환경 동기화
uv sync

# 3) 테스트 확인
uv run pytest -q

# 4) MCP 서버 실행
uv run va-mcp

va-mcpはstdioトランスポートで動作するため、MCPクライアント(IDE/Agent)からサーバーに接続して使用します。

開発ルール

チームの開発ルール(ブランチ戦略、テスト、PR、コミットルール)は dev-guide.md を参照してください。

テストガイド

機能開発後、以下の順序でテストを行います。

# 1) 의존성 동기화
uv sync

# 2) 테스트 실행
uv run pytest -q

• テストコードはルートの tests/ フォルダに作成します。

• 新しい機能を追加する場合は、対応するテストを必ず一緒に作成してください。

• 最小基準:

  • 機能単位テスト1つ以上

  • tests/test_smoke.py が常にパスすること

ディレクトリの役割

• src/va_mcp/: アプリケーションソースコードのルート

• src/va_mcp/server.py: MCPサーバーのエントリーポイント (va-mcp 実行時に開始されるファイル)

• src/va_mcp/app.py: FastMCP アプリの作成および初期化

• src/va_mcp/config.py: 環境変数の読み込み、出力ディレクトリの設定

• src/va_mcp/registry/: どの機能(tool)とデータ(resource)をMCPに表示するかを登録する場所

• src/va_mcp/tools/: MCPが実際に実行する機能関数 (例: ping、チェック実行)

• src/va_mcp/resources/: 機能で共通して使用する基準データ集 (例: サポートされているチェックリスト)

• tests/: テストコード (開発完了後、必須実行)

• outputs/: 実行結果の成果物保存先

Notes

• 現在はローカル連携(stdio)基準で設計されています。

• 今後、AWSデプロイ段階でHTTP方式に切り替える予定です。