Scanoss MCP Server

🚀 SCANOSS MCP 服務器

SCANOSS MCP 服務器整合了 SCANOSS 技術與 Model Context Protocol (MCP)，可對代碼進行掃描，確保其符合開源許可要求，有效降低法律風險。

🚀 快速開始

SCANOSS MCP 服務器將 SCANOSS 的開源掃描功能與 Model Context Protocol 相結合，讓語言模型能夠掃描代碼片段，檢測未聲明的開源內容，檢查開源許可證組合的合規性與兼容性問題，並提供關於代碼中開源組件的可操作見解。藉助該服務器，AI 助手能即時反饋其生成或修改的代碼，確保符合開源許可要求。

✨ 主要特性

• 代碼掃描：可檢測代碼片段中的開源組件，涵蓋完整的組件、文件和代碼段。
• 許可證合規性：分析許可證組合，識別兼容性和合規性問題。
• 格式化結果：能接收結構良好且可操作的掃描結果。
• 可選 API 密鑰：支持免費（osskb.org）和企業版 SCANOSS 實例。

📦 安裝指南

先決條件

• Python 3.12+
• uv 用於 Python 包管理
• SCANOSS Python SDK
• MCP Python SDK

本地安裝

1. 克隆此倉庫：

   git clone https://github.com/matiasdaloia/scanoss-mcp-server.git
   cd scanoss-mcp-server
   

2. 使用 uv 安裝依賴項：

   uv venv
   uv pip install -e .
   

3. （可選）在根目錄下創建一個 .env 文件並添加 SCANOSS API 密鑰：

   SCANOSS_API_KEY=your_api_key_here
   SCANOSS_API_URL=https://your-scanoss-instance.com/api/scan/direct
   

   如果未提供 API 密鑰，服務器將使用免費的 osskb.org 服務。

Docker 安裝

1. 拉取預構建的 Docker 鏡像：

   docker pull mcp/scanoss-mcp-server
   

   或自行構建：

   docker build -t mcp/scanoss-mcp-server .
   

2. 使用 Docker 運行：

   docker run -i --rm -e SCANOSS_API_KEY=your_key_here -e SCANOSS_API_URL=https://your-scanoss-instance.com/api/scan/direct mcp/scanoss-mcp-server
   

💻 使用示例

基礎用法

運行服務器

本地使用 uv

運行 MCP 服務器：

uv run scanoss_mcp_server.py

使用 Docker

docker run -i --rm -e SCANOSS_API_KEY=your_key_here -e SCANOSS_API_URL=https://your-scanoss-instance.com/api/scan/direct mcp/scanoss-mcp-server

配置客戶端

針對 Claude Desktop 的配置示例如下：

{
  "mcp_server": {
    "host": "localhost",
    "port": 8000,
    "api_key": "your_api_key_here"
  }
}

📄 許可證

本項目採用 MIT License，具體條款見 LICENSE 文件。