READMEmain

CVE Search MCP Server

This MCP server provides an interface for searching for Common Vulnerabilities and Exposures (CVE) information. It allows users to query CVE databases and retrieve details about known vulnerabilities.

Overview

The CVE Search MCP server offers the following features:

CVE Search: Enables searching for CVEs based on keywords, IDs, or other criteria.
Detailed Information: Provides comprehensive information about each CVE, including its description, affected products, and severity scores.
API Access: Offers an API endpoint for programmatic access to CVE data.

Getting Started

Prerequisites

Python 3.7+
uv package manager

Installation

Clone the repository:

git clone https://github.com/nonsleepr/mcp-cve-search.git
    cd mcp-cve-search

Install the dependencies using uv:
```
uv sync
```

Running the Server

To start the CVE Search MCP server, run the following command:

uv run mcp-cve-search

MCP Registration/Running

To register and run this MCP server, add the following configuration to your MCP settings file (e.g., ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json):

"cve-search": {
  "command": "uvx",
  "args": [
    "--no-cache",
    "--from",
    "https://github.com/nonsleepr/mcp-cve-search.git",
    "mcp-cve-search"
  ]
}

Ensure that uvx is installed and available in your environment. You may need to install it using pip install uv.

Usage

The server provides a tool for searching CVEs. You can use the search_cve tool with a query to find relevant CVEs.

Example:

{
  "tool_name": "search_cve",
  "arguments": {
    "query": "example vulnerability"
  }
}

Development

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository.
Create a new branch for your feature or bug fix.
Implement your changes.
Submit a pull request.

Building and Publishing

To build and publish the package:

Build package distributions:
```
uv build
```
Publish to PyPI:
```
uv publish
```

License

This project is licensed under the MIT License.

mcp-cve-search