OSV MCP Server

OSV MCP サーバー

このプロジェクトは、OSV（Open Source Vulnerabilities）のデータとツールをAI アシスタントや大規模言語モデル（LLM）と統合するためのMCP（Model Context Protocol）サーバーを提供します。サーバーはPythonで実装されており、LLMがワークフローや機能を拡張するために利用できるツールとリソースを公開します。以下は、OSV MCP サーバーを使用しているClaude Desktopのスクリーンショットです。

特長

• MCPプロトコルを介してOSV関連のデータを公開します
• MCPに対応したAI アシスタントやLLMに簡単に接続できます
• Pythonベースのシンプルなセットアップ

前提条件

• お使いのシステムに**Python 3.8+**がインストールされていること
• uv（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

AI アシスタントやLLMでMCP サーバーを使用する

MCP サーバーは、ローカルまたはネットワーク経由でアクセス可能なAPIを通じて、ツールとリソースを公開します。Model Context Protocolに対応したAI アシスタントやLLMは、1つ以上のMCP サーバーに接続して機能を拡張できます。接続すると、アシスタントはquery_vulnerabilitiesツールを呼び出せます。

MCP サーバーの追加や設定方法については、お使いのAI アシスタントまたはLLMのドキュメントを参照してください。

Claude DesktopでOSV MCP サーバーを使用する

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ライセンス（または、ここにライセンスを指定してください）

---

ご質問やサポートが必要な場合は、issueを作成するか、メンテナーにお問い合わせください。