Osv MCP

🚀 OSV MCP サーバー

このプロジェクトは、MCP（モデルコンテキストプロトコル）に基づくサーバーを提供します。このサーバーは、OSV（オープンソースバリデーション）データとツールを統合し、AI アシスタントや大規模言語モデル (LLMs) との統合を可能にします。サーバーは Python で実装されており、LLMs が使用できるツールとリソースを公開し、そのワークフローと機能を強化します。下の画像は、Claude Desktop が OSV MCP サーバーをどのように使用するかを示しています。

✨ 主な機能

• MCP プロトコルを通じて OSV 関連データを公開
• MCP 対応の AI アシスタントや LLMs への簡単な接続
• シンプルな 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

💻 使用例

MCP サーバーと AI アシスタントおよび LLMs の使用

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

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

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（またはここで指定されたライセンス）

さらなる質問やサポートが必要な場合は、イシューを開くか、メンテナに連絡してください。