NVD データベース MCP サーバー

API を介して NIST 国家脆弱性データベース (NVD) を照会するためのモデルコンテキストプロトコルサーバーの実装。https ://nvd.nist.gov/

前提条件として、NVD API キーが必要です。(こちらからリクエストしてください)。

状態

stdioおよびsseトランスポートの両方を使用して、Claude デスクトップアプリおよびその他の MCP 準拠のホストおよびクライアントで動作します。

特徴

詳細な脆弱性データを使用して、ID で特定の CVE をクエリします。
カスタマイズ可能な結果オプションを使用して、キーワードで NVD データベースを検索します。
リアルタイム通信のための Server-Sent Events (SSE) トランスポートをサポートします。
Claude Desktop などの MCP 準拠クライアントと互換性があります。

ツール

サーバーは、NVD データベースを照会するために次のツールを実装します。

get_cve :
- 説明: ID で CVE レコードを取得します。
- パラメータ:
  - cve_id (str): CVE ID (例: CVE-2019-1010218 )。
  - concise (bool、デフォルトはFalse ): Trueの場合は、より短い形式を返します。
- 返されるもの: スコア、弱点、参照を含む詳細な CVE 情報。
search_cve :
- 説明: キーワードで NVD データベースを検索します。
- パラメータ:
  - keyword (str): 検索用語 (例: Red Hat )。
  - exact_match (bool、デフォルトはFalse ): Trueの場合は、正確なフレーズ一致が必要です。
  - concise (bool、デフォルトはFalse ): Trueの場合は、短い CVE レコードを返します。
  - results (int, default 10 ): CVE レコードの最大数 (1-2000)。
- 返される値: 一致する CVE とその合計数のリスト。

構成

次の場所にある Claude Desktop 構成ファイルを作成または編集します。
- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
以下を追加します。

{
  "mcpServers": {
    "mcp-nvd": {
      "command": "/path/to/uvx",
      "args": ["mcp-nvd"],
      "env": {
        "NVD_API_KEY": "your-api-key"
      }
    }
  }
}

/path/to/uvxをuvx実行ファイルへの絶対パスに置き換えます。ターミナルでwhich uvxコマンドのパスを確認してください。これにより、サーバーの起動時に正しいバージョンのuvxが使用されるようになります。
変更を適用するには、Claude Desktop を再起動します。

発達

設定

前提条件:
- Python 3.10 以上。
- NVD API キー (こちらからリクエスト)。
- uvパッケージマネージャー (インストール)。
リポジトリのクローンを作成します:

git clone https://github.com/marcoeg/mcp-nvd
cd mcp-nvd

環境変数を設定する:
- プロジェクトルートに.envファイルを作成します。
  NVD_API_KEY=your-api-key
- your-api-key NVD API キーに置き換えます。
依存関係をインストール:

uv sync
uv pip install -e .

MCPインスペクターで実行する

cd /path/to/the/repo
source .env

npx @modelcontextprotocol/inspector uv \
    --directory /path/to/repo/mcp-nvd run mcp-nvd

次に、MCP インスペクターによって示された URL (通常はhttp://localhost:8077?proxyPort=8078をブラウザで開きます。

インスペクターでstdioとsseトランスポートタイプを自由に切り替えます。

SSEクライアントでのテスト

サーバーを実行します。

cd /path/to/the/repo
source .env

uv run mcp-nvd --transport sse --port 9090

デフォルトではポート9090で SSE トランスポートを使用して実行されます。

クライアントを実行します。

get_cveをテストします:

uv run client.py http://localhost:9090/sse CVE-2019-1010218

テストsearch_cve (デフォルト 10 件の結果):

uv run client.py http://localhost:9090/sse "search:Red Hat"

テストsearch_cve (完全一致、5 件の結果):

uv run client.py http://localhost:9090/sse "search:Microsoft Windows:exact:5"

Dockerのセットアップ

建てる

docker build -t mcp-nvd:latest .

走る

.envの場合:

docker run -d -p 9090:9090 -v /path/to/.env:/app/.env mcp-nvd:latest

env var の場合:

docker run -d -p 9090:9090 -e NVD_API_KEY="your-key" mcp-nvd:latest

カスタムポート:

docker run -d -p 8080:8080 -v /path/to/.env:/app/.env mcp-nvd:latest uv run mcp-nvd --transport sse --port 8080 --host 0.0.0.0

確認する

docker logs <container_id>
# Expect: INFO: Uvicorn running on http://0.0.0.0:9090

テスト：

uv run client.py http://localhost:9090/sse CVE-2019-1010218

注記

.envにNVD_API_KEY=your-keyがあることを確認するか、 -eを使用してください。
デフォルトポート: 9090 。

以下は、コードブロック内の Markdown コメントとしてフォーマットされた概要です。これは、 docker-compose.yamlやREADME.mdなどのファイルに含めるのに適しています。

テストに Docker Compose を使用する

このdocker-compose.yaml 、 tests/ディレクトリにあり、ビルド済みのDockerイメージを用いてMCP-NVDサーバーをテストするためのサービスを定義します。これは、 clickhouseのようなスタンドアロンサービスと同様に、テストユースケース向けに設計されており、イメージは毎回再構築されるのではなく、事前にビルドされることを前提としています。

仮定

ビルド済みイメージ：このサービスは、ローカルまたはレジストリで利用可能なmcp-nvd:testタグ付きのビルド済みイメージを使用します。このイメージは親ディレクトリにあるDockerfileに基づいており、 uvを使用して MCP-NVD サーバーをセットアップし、ポート 9090 で SSE モードで実行します。

イメージの構築方法

mcp-nvd:testイメージを作成するには:

プロジェクトルートに移動します。
cd ./mcp-nvd
Dockerfile を使用してイメージをビルドします。
docker build -t mcp-nvd:test .
- これにより、 pyproject.tomlとmcp_nvd/モジュールからのすべての依存関係を含むイメージがビルドされ、サーバーを実行するためのデフォルトのコマンドが設定されます。

サービスの実行

tests/ディレクトリから:

cd tests
docker-compose up

アクセス: サーバーはhttp://localhost:9090で実行されます。
停止: docker-compose down 。
環境: NVD_API_KEYが../.envにあることを確認するか、 docker-compose --env-file ../.env upを使用します。

Docker Compose シナリオで`test_tools.py`を実行する

Docker 環境内でユニットテスト ( test_tools.py ) を実行するには:

サービスを開始します。docker docker-compose upを実行して、 mcp-nvdサービスが実行されていることを確認します。
コンテナ内で実行:
- コンテナ名 (例: mcp-nvd-mcp-nvd-1 ) を次のように識別します。
  docker ps
- コンテナ内でテストを実行します。
  docker exec -it mcp-nvd-mcp-nvd-1 python /app/tests/test_tools.py
- 注： test_tools.pyがイメージの/app/tests/にコピーされていることを前提としています。コピーされていない場合は、Dockerfileに以下を追加してください。
  COPY tests/ ./tests/
  次に、ルートからdocker build -t mcp-nvd:test .を使用してイメージを再構築します。
代替案: コンテナ化されたサービスに対してローカルでテストを実行します。
cd tests python test_tools.py
- これは、サービスの実行中にhttp://localhost:9090に対してテストを行います。

主な詳細

ポート: 9090 は SSE アクセス用に公開されています。
ログ: log-dataボリュームに保存されます (オプション)。
イメージ: docker-composeを実行する前に、一度ビルドしてmcp-nvd:testとしてタグ付けする必要があります。

SSE ベースの MCP クライアントとサーバーの動作パターンを提供してくれた@sidharthrajaramに感謝します: https://github.com/sidharthrajaram/mcp-sse

Integrations