🚀 OSV MCP 服务器

此项目搭建了一个基于 MCP（模型上下文协议）的服务器，主要用于整合 OSV（开源漏洞）数据与工具，还能和 AI 助手或大型语言模型 (LLMs) 实现集成。该服务器采用 Python 编写，为 LLMs 开放了可用的工具和资源，有效增强了其工作流程和功能。下面的图片展示了 Claude Desktop 如何使用 OSV MCP 服务器。

🚀 快速开始

此项目提供了一个基于 MCP 协议的服务器，用于整合 OSV 数据和工具，并与 AI 助手或 LLMs 集成。通过简单的安装步骤，就能开启使用。

✨ 主要特性

• 通过 MCP 协议公开 OSV 相关数据。
• 方便连接支持 MCP 的 AI 助手或 LLMs。
• 基于 Python，设置简单。

📦 安装指南

1. 克隆仓库

将此仓库克隆到本地机器：

git clone https://github.com/your-org/osv-mcp.git
cd osv-mcp

2. 创建虚拟环境（推荐）

为了防止依赖冲突，建议使用虚拟环境：

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv

3. 安装依赖项

使用 uv 安装所需的 Python 包：

uv sync

4. 启动 MCP 服务器

运行以下命令启动服务器：

uv run vulns.py

💻 使用示例

基础用法

MCP 服务器通过本地或网络可访问的 API 公开工具和资源。支持 MCP 的 AI 助手或 LLMs 可以连接到一个或多个 MCP 服务器来扩展其功能。一旦连接，助手可以调用 query_vulnerabilities 工具。

请参考您的 AI 助手或 LLM 的文档以获取具体添加或配置 MCP 服务器的说明。

高级用法

使用 OSV MCP 服务器与 Claude Desktop

在 claude_desktop_config.json 文件中添加 OSV MCP 服务器。 在 Mac 或 Linux 上编辑：~/Library/Application\ Support/Claude/claude_desktop_config.json。 在 Windows 上编辑：env:AppData\Claude\claude_desktop_config.json。 将 OSV MCP 服务器添加到配置文件如下：

{
    "mcpServers": {
        "vulns": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/osv-mcp",
                "run",
                "vulns.py"
            ]
        }
    }
}

📚 详细文档

开发

• 源代码位于 vulns.py。
• 项目依赖项由 pyproject.toml 管理。

📄 许可证

MIT License（或在此指定您的许可）

如需进一步问题或支持，请打开问题或联系维护者。