Skip to main content
Glama
CVSS Calculator MCP

CVSS Calculator MCP

README.md
<h1 align="center">CVSS Calculator MCP</h1>

<p align="center">A lightweight CVSS Base Score calculator for AI agents, built with Go.</p>

<div align="center">

[![Version 1.1.0](https://img.shields.io/badge/version-v1.1.0-2563eb?style=flat-square)](https://github.com/alfa-reza/cvss-calculator-mcp/releases)
[![Go version](https://img.shields.io/github/go-mod/go-version/alfa-reza/cvss-calculator-mcp?style=flat-square&logo=go&label=Go)](go.mod)
[![CI status](https://img.shields.io/github/actions/workflow/status/alfa-reza/cvss-calculator-mcp/ci.yml?branch=main&label=CI&style=flat-square)](https://github.com/alfa-reza/cvss-calculator-mcp/actions/workflows/ci.yml)
[![License](https://img.shields.io/github/license/alfa-reza/cvss-calculator-mcp?style=flat-square)](LICENSE)
<br>
[![MCP](https://badge.mcpx.dev)](https://registry.modelcontextprotocol.io/?q=io.github.alfa-reza%2Fcvss-calculator-mcp)
[![mcptry score](https://mcptry.com/badge/io.github.alfa-reza/cvss-calculator-mcp)](https://mcptry.com/servers/io.github.alfa-reza/cvss-calculator-mcp)
[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/alfa-reza/cvss-calculator-mcp)
[![CVSS Calculator MCP on mcprush](https://mcprush.com/badge/cvss-calculator-mcp/score.svg)](https://mcprush.com/to/cvss-calculator-mcp?ref=badge)
[![M8ven Score](https://m8ven.ai/badge/mcp/alfa-reza-cvss-calculator-mcp-1larrv?v=c1f567e28406ccfe42d46af3e1d1b022)](https://m8ven.ai/mcp/alfa-reza-cvss-calculator-mcp-1larrv?s=readme)
[![LobeHub](https://img.shields.io/badge/LobeHub-MCP-5A67D8?style=flat-square)](https://lobehub.com/mcp/alfa-reza-cvss-calculator-mcp)
[![Glama](https://glama.ai/mcp/servers/alfa-reza/cvss-calculator-mcp/badges/score.svg)](https://glama.ai/mcp/servers/alfa-reza/cvss-calculator-mcp)
[![Glama Connector](https://img.shields.io/badge/Glama-Connector-4B5563?style=flat-square)](https://glama.ai/mcp/connectors/id.my.cvss/cvss-calculator-mcp)

</div>

<p align="center">
  <a href="https://cvss.my.id">Website</a> ·
  <a href="https://cvss.my.id/docs/mcp/">Docs</a> ·
  <a href="https://registry.modelcontextprotocol.io/?q=io.github.alfa-reza%2Fcvss-calculator-mcp">MCP Registry</a>
</p>

Calculate and validate **CVSS 2.0, 3.0, 3.1, and 4.0** Base Scores through a single MCP tool: `calculate_cvss`. Supports local **stdio** and remote **Streamable HTTP**.

## Quick Start

For agent-guided setup, copy this prompt to your AI agent:

```text
Read https://get.cvss.my.id/LLM.txt and follow its instructions to set up CVSS Calculator MCP and offer to install its vulnerability assessment skill.
```

The agent will ask you to choose and approve a local or remote connection before making changes.

### Option 1 — Install Locally

**Linux / macOS:**

```bash
curl -fsSL https://get.cvss.my.id/install.sh | bash
```

**Windows (PowerShell, x64 or ARM64):**

```powershell
irm https://raw.githubusercontent.com/alfa-reza/cvss-calculator-mcp/main/install.ps1 | iex
```

The installer prints the binary location; add that directory to your PATH or use the full path in your MCP client.

Verify with `cvss-calculator-mcp --version`, then add the binary to your MCP client (choose one):

```bash
# Claude Code
claude mcp add --scope user cvss-calculator -- cvss-calculator-mcp

# Codex
codex mcp add cvss-calculator -- cvss-calculator-mcp

# OpenCode v2
opencode mcp add cvss-calculator --global -- cvss-calculator-mcp
```

Also available via [GitHub Releases](https://github.com/alfa-reza/cvss-calculator-mcp/releases) (including Windows) or `go install github.com/alfa-reza/cvss-calculator-mcp/cmd/cvss-calculator-mcp@latest` (Go 1.25+). Ensure the binary is in your `PATH`.

### Option 2 — Free Remote MCP

No installation or API key required. Connect to `https://cvss.my.id/mcp`:

```bash
# Claude Code
claude mcp add --scope user --transport http cvss-calculator https://cvss.my.id/mcp

# Codex
codex mcp add cvss-calculator --url https://cvss.my.id/mcp

# OpenCode v2
opencode mcp add cvss-calculator --global --url https://cvss.my.id/mcp
```

**Rate limit:** 5 requests per minute per IP address. Use the local option to avoid this shared-service limit.

<details>
<summary><strong>Other MCP clients (Cursor, Claude Desktop, VS Code, etc.)</strong></summary>

Use `cvss-calculator-mcp` as a **local stdio command**, or `https://cvss.my.id/mcp` as a **remote Streamable HTTP endpoint**. Configuration formats depend on the client.

**Cursor / Claude Desktop** — local configuration (`mcpServers`):

```json
{
  "mcpServers": {
    "cvss-calculator": { "command": "cvss-calculator-mcp" }
  }
}
```

For **Cursor remote**, use `"url": "https://cvss.my.id/mcp"` instead of the `command` entry.

**VS Code** — remote configuration (`.vscode/mcp.json`):

```json
{
  "servers": {
    "cvss-calculator": { "type": "http", "url": "https://cvss.my.id/mcp" }
  }
}
```

See the client documentation for configuration locations and setup: [Cursor](https://cursor.com/docs/mcp) · [Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers) · [VS Code](https://code.visualstudio.com/docs/agent-customization/mcp-servers). Full copy-paste guides for all supported clients are available in the [MCP docs](https://cvss.my.id/docs/mcp/clients/).

</details>

## Usage

Ask your connected AI assistant:

> Calculate the CVSS 3.1 Base Score for `CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H`.

The `calculate_cvss` tool accepts `version` and `vector`, returning a score and severity (for this example, **9.8 — Critical**). Only complete **Base** vectors are supported; no CVE lookups or vulnerability scanning.

### Vulnerability Assessment Skill

Install the optional skill to guide your agent in assessing discovered vulnerabilities, selecting CVSS metrics, and calculating Base Scores with this MCP server:

```bash
npx skills add alfa-reza/cvss-calculator-mcp --skill vulnerability-cvss-assessment
```

Choose your agent when prompted. Add `--global` to make the skill available across projects. The skill requires the MCP server configured as described in Quick Start. See its [instructions](skills/vulnerability-cvss-assessment/SKILL.md) and [tool reference](skills/vulnerability-cvss-assessment/references/tool-reference.md).

## Self-Hosting

The Go binary uses **stdio** by default. For Streamable HTTP, run `cvss-calculator-mcp --transport http` (listens on `127.0.0.1:43871/mcp` by default; customize with `--listen`).

## License

[Apache-2.0](LICENSE). CVSS is maintained by [FIRST](https://www.first.org/cvss/); this project is independent of FIRST.