CVSS Calculator MCP
by alfa-reza
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">
[](https://github.com/alfa-reza/cvss-calculator-mcp/releases)
[](go.mod)
[](https://github.com/alfa-reza/cvss-calculator-mcp/actions/workflows/ci.yml)
[](LICENSE)
<br>
[](https://registry.modelcontextprotocol.io/?q=io.github.alfa-reza%2Fcvss-calculator-mcp)
[](https://mcptry.com/servers/io.github.alfa-reza/cvss-calculator-mcp)
[](https://mcpservers.org/servers/alfa-reza/cvss-calculator-mcp)
[](https://mcprush.com/to/cvss-calculator-mcp?ref=badge)
[](https://m8ven.ai/mcp/alfa-reza-cvss-calculator-mcp-1larrv?s=readme)
[](https://lobehub.com/mcp/alfa-reza-cvss-calculator-mcp)
[](https://glama.ai/mcp/servers/alfa-reza/cvss-calculator-mcp)
[](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.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues