OSV MCP

🚀 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

  • 查询 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

📖 参考资料

• GitHub 仓库
• MCP 协议文档
• OSV 数据库

💌 反馈与支持

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