返回 MCP 目录
public公开dns本地运行

OSV-MCP

一个轻量级的MCP服务器,用于查询OSV数据库中的软件包漏洞信息。

article

README

🚀 OSV 数据库 MCP 服务器

这是一个轻量级的 MCP(模型上下文协议)服务器,专为 OSV 数据库 API 打造,能助力你高效查询相关信息。

示例:

演示

🚀 快速开始

本项目是一个轻量级的 MCP 服务器,用于 OSV 数据库 API,能让你方便地查询包的 CVE 信息、受影响版本和修复版本等。

✨ 主要特性

  • 提供多个实用工具,可查询包的 CVE ID、受影响版本、修复版本以及支持的生态系统。
  • 支持通过不同方式安装,包括在线安装和本地安装。

📦 安装指南

在线安装

通过 Smithery 安装:

npx -y @smithery/cli install @EdenYavin/OSV-MCP --client claude

本地安装

  1. 克隆仓库:https://github.com/EdenYavin/OSV-MCP.git
  2. 配置你的 MCP 主机(光标 / Claude 桌面等):
{
  "mcpServers": {
    "osv-mcp": {
      "command": "uv",
      "args": ["--directory", "path-to/OSV-MCP", "run", "osv-server"],
      "client": "claude"
    }
  }
}

📚 详细文档

提供的工具

概述

| 名称 | 描述 | |------|------| | query_package_cve | 列出特定包的所有 CVE ID。可以指定具体版本以获取更窄范围的 CVE ID。 | | query_for_cve_affected | 查询 OSV 数据库中的一个 CVE,返回所有受影响的版本。 | | query_for_cve_fix_versions | 查询 OSV 数据库中的一个 CVE,返回修复漏洞的所有版本。 | | get_ecosystems | 查询 MCP 以获取当前支持的生态系统。 |

详细描述

  • query_package_cve

    • 查询 OSV 数据库中的某个包,并返回其 CVE ID。
    • 输入参数:
      • package (字符串,必填):要查询的包名
      • version (字符串,可选):要查询的包版本。如果未指定,默认查询所有版本
      • ecosystem (字符串,可选):包的生态系统。默认为 "PyPI"(Python 包)
    • 返回一个包含 CVE ID 及其详细信息的列表
  • query_for_cve_affected

    • 查询 OSV 数据库中的一个 CVE,并返回所有受影响的版本。
    • 输入参数:
      • cve (字符串,必填):要查询的 CVE ID(例如 "CVE-2018-1000805")
    • 返回一个包含受影响版本字符串的列表
  • query_for_cve_fix_versions

    • 查询 OSV 数据库中的一个 CVE,并返回所有修复漏洞的版本。
    • 输入参数:
      • cve (字符串,必填):要查询的 CVE ID(例如 "CVE-2018-1000805")
    • 返回一个包含已修复版本字符串的列表
  • get_ecosystems

    • 查询 MCP 以获取所有当前支持的生态系统。
    • 返回一个字典,键为生态系统名称,值为编程语言 / 操作系统。

前提条件

  1. Python 3.11 或更高版本:此项目要求 Python 3.11 或更新版本。

    # 检查你的 Python 版本
    python --version
    
  2. 安装 uv:一个快速的 Python 包安装程序和解析器。

    pip install uv
    

    或使用 Homebrew:

    brew install uv
    

已测试的环境

  • [X] Cursor(光标)
  • [X] Claude

📖 参考资料

💌 反馈与支持

如果对该项目有帮助,请在 VibeApp 上给我一个五星好评! 😊

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端