Scanoss MCP Server

🚀 SCANOSS MCP Server

A server based on the Model Context Protocol (MCP) that integrates SCANOSS technology to scan code for open - source license compliance.

🚀 Quick Start

The SCANOSS MCP Server integrates SCANOSS's open - source scanning capabilities with the Model Context Protocol, enabling language models to:

1. Scan code snippets to detect undeclared open - source content.
2. Check the compliance and compatibility of open - source license combinations.
3. Provide actionable insights into the open - source components in the code.

By using this server, AI assistants can provide real - time feedback on the code they generate or modify, ensuring compliance with open - source license requirements and reducing legal risks.

✨ Features

• Code Scanning: Detect open - source components in code snippets, including complete components, files, and code segments.
• License Compliance: Analyze license combinations to identify compatibility and compliance issues.
• Formatted Results: Receive well - structured and actionable scan results.
• Optional API Key: Support free (osskb.org) and enterprise - level SCANOSS instances.

📦 Installation

Prerequisites

• Python 3.12+
• uv for Python package management
• SCANOSS Python SDK
• MCP Python SDK

Local Installation

1. Clone this repository:

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

2. Install dependencies using uv:

uv venv
uv pip install -e .

3. (Optional) Create a .env file in the root directory and add the SCANOSS API key:

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

If no API key is provided, the server will use the free osskb.org service.

Docker Installation

1. Pull the pre - built Docker image:

docker pull mcp/scanoss-mcp-server

Or build it yourself:

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

2. Run with 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

💻 Usage Examples

Running the Server

Locally with uv

Run the MCP server:

uv run scanoss_mcp_server.py

Using 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

Configuring the Client

An example configuration for Claude Desktop is as follows:

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

🤝 Contribution

Contributions are welcome! Please refer to the project documentation to learn how to contribute.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.