SCANOSS MCP 服务器

一个基于 Model Context Protocol (MCP) 的服务器，整合了 SCANOSS 技术，用于扫描代码以确保开源许可合规性。

概述

SCANOSS MCP 服务器将 SCANOSS 的开源扫描功能与 Model Context Protocol 整合在一起，使语言模型能够：

1. 扫描代码片段以检测未声明的开源内容
2. 检查开源许可证组合的合规性和兼容性问题
3. 提供关于代码中开源组件的可操作见解

通过使用此服务器，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 文件。