MCP server de SEMCL.ONE
Commit 14 nov 2026Proporciona a los LLM capacidades de análisis de composición de software, incluyendo cumplimiento de licencias, análisis de binarios y evaluación de vulnerabilidades.
También conocido como SemClone/mcp-semclone
- Stars
- 2
- Herramientas
- 14
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 14 nov 2026
- Licencia
- Apache-2.0
¿Qué es SEMCL.ONE MCP?
SEMCL.ONE es un MCP server. Proporciona a los LLM capacidades de análisis de composición de software, incluyendo cumplimiento de licencias, análisis de binarios y evaluación de vulnerabilidades. Expone 14 herramientas, como scan_directory, scan_binary, check_package.
Resumen generado a partir del README del proyecto
Acerca del MCP server de SEMCL.ONE
mcp-semclone permite realizar análisis de composición de software y auditorías de cumplimiento de licencias directamente desde un cliente de IA. Proporciona a desarrolladores y equipos de seguridad herramientas para escanear bases de código, identificar componentes de código abierto y evaluar riesgos de seguridad. El servidor integra la cadena de herramientas SEMCL.ONE, lo que permite a un LLM ejecutar tareas complejas como el análisis de binarios para archivos APK, EXE, DLL, SO y JAR, o la generación de un Software Bill of Materials en formato CycloneDX.
Los usuarios pueden configurar el servidor localmente mediante pip o pipx. Aunque funciona directamente, proporcionar un GITHUB_TOKEN o una NVD_API_KEY puede aumentar los límites de velocidad para las consultas de vulnerabilidades. El servidor utiliza herramientas especializadas como purl2notices para la detección de paquetes, binarysniffer para archivos compilados y ospac para la validación de políticas. Está diseñado para gestionar desde comprobaciones simples de paquetes hasta flujos de trabajo completos de cumplimiento que validan licencias según las políticas organizacionales.
Qué puedes hacer con él
- 1Auditar aplicaciones móviles compiladasAnaliza un archivo Android APK para identificar sus componentes de código abierto y las licencias asociadas.
- 2Automatizar la creación de SBOMGenera un Software Bill of Materials completo en formato CycloneDX para un proyecto.
- 3Verificar el cumplimiento de políticas de licenciasComprueba si las licencias encontradas en una base de código son compatibles con políticas de distribución organizacionales específicas.
- 4Evaluar vulnerabilidades de seguridadEscanea un proyecto para encontrar problemas de seguridad críticos consultando múltiples bases de datos de vulnerabilidades.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de SEMCL.ONE MCP 14
Detectado desde el READMEscan_directoryscan_binarycheck_packagedownload_and_scan_packagegenerate_legal_noticesgenerate_legal_notices_from_purlsgenerate_sbomvalidate_policyvalidate_license_listget_license_obligationscheck_license_compatibilityget_license_details
| scan_directory | — | |
| scan_binary | — | |
| check_package | — | |
| download_and_scan_package | — | |
| generate_legal_notices | — | |
| generate_legal_notices_from_purls | — | |
| generate_sbom | — | |
| validate_policy | — | |
| validate_license_list | — | |
| get_license_obligations | — | |
| check_license_compatibility | — | |
| get_license_details | — |
Mostrar las 14 herramientasMostrar menos herramientas
analyze_commercial_riskrun_compliance_check
| analyze_commercial_risk | — | |
| run_compliance_check | — |
Configuración
BINARYSNIFFER_PATHGITHUB_TOKENNVD_API_KEYOSPAC_PATHOSSLILI_PATHPURL2NOTICES_PATHUPMEX_PATHVULNQ_PATH
| Nombre | Descripción | Tipo |
|---|---|---|
| BINARYSNIFFER_PATH | — | |
| GITHUB_TOKEN | — | |
| NVD_API_KEY | — | |
| OSPAC_PATH | — | |
| OSSLILI_PATH | — | |
| PURL2NOTICES_PATH | — | |
| UPMEX_PATH | — | |
| VULNQ_PATH | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblesemclone/mcp-semclone is public and reachablegithub.com/semclone/mcp-semclone ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/semclone/mcp-semclone ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo14 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubmcp-semclone - Model Context Protocol Server for SEMCL.ONE
MCP (Model Context Protocol) server that provides LLMs with comprehensive OSS compliance and vulnerability analysis capabilities through the SEMCL.ONE toolchain.
Overview
mcp-semclone integrates the complete SEMCL.ONE toolchain to provide LLMs with powerful software composition analysis capabilities:
- License Detection & Compliance: Scan codebases for licenses and validate against policies
- Binary Analysis: Analyze compiled binaries (APK, EXE, DLL, SO, JAR) for OSS components and licenses
- Vulnerability Assessment: Query multiple vulnerability databases for security issues
- Package Discovery: Identify packages from source code and generate PURLs
- SBOM Generation: Create Software Bill of Materials in CycloneDX format
- Policy Validation: Check license compatibility and organizational compliance
Features
Tools
Analysis & Scanning:
scan_directory- Comprehensive directory scanning for packages, licenses, and vulnerabilitiesscan_binary- Analyze compiled binaries (APK, EXE, DLL, SO, JAR) for OSS componentscheck_package- Check specific packages for licenses and vulnerabilitiesdownload_and_scan_package- Download package source from registries and perform deep license/copyright scanning
Legal Notices & Documentation:
generate_legal_notices- Generate legal notices by scanning source code directly (fast, recommended)generate_legal_notices_from_purls- Generate legal notices from PURL list (downloads from registries)generate_sbom- Generate Software Bill of Materials in CycloneDX format
License & Policy Validation:
validate_policy- Validate licenses against organizational policiesvalidate_license_list- Quick license safety validation for distribution typesget_license_obligations- Get detailed compliance requirements for licensescheck_license_compatibility- Check if two licenses can be mixedget_license_details- Get comprehensive license information including full textanalyze_commercial_risk- Assess commercial distribution risks
Complete Workflows:
run_compliance_check- Universal one-shot compliance workflow for any project type
Resources
license_database- Access license compatibility informationpolicy_templates- Get pre-configured policy templates
Prompts
compliance_check- Guided workflow for license compliance checkingvulnerability_assessment- Guided workflow for security assessment
Installation
Single Command Installation
pip install mcp-semclone
This automatically installs all required SEMCL.ONE tools:
- purl2notices - Comprehensive package detection and license extraction
- osslili - License detection from archives (used by check_package)
- binarysniffer - Binary analysis for OSS components
- ospac - Policy validation engine
- vulnq - Vulnerability database queries
- upmex - Package metadata extraction (used by check_package)
Pipx Installation (Recommended for Global Access)
pipx installs the package in an isolated environment while making the CLI tools globally available. This is ideal for avoiding dependency conflicts with other Python packages on your system.
# Install pipx if you don't have it
pip install pipx
pipx ensurepath
# Install mcp-semclone
pipx install mcp-semclone
# IMPORTANT: Inject all SEMCL.ONE tool dependencies into the same isolated environment
# This ensures all tools are available both as libraries and CLI commands
# Required by some agents that need direct CLI tool access
# Use --include-apps to make CLI commands globally available
pipx inject mcp-semclone purl2notices purl2src osslili binarysniffer ospac vulnq upmex --include-apps
Benefits of pipx:
- ✅ Isolated environment prevents dependency conflicts
- ✅ All tools globally accessible in PATH
- ✅ Easy to update:
pipx upgrade mcp-semclone - ✅ Clean uninstall:
pipx uninstall mcp-semclone
For detailed setup instructions including:
- IDE-specific configurations (Cursor, Cline, Kiro, VS Code, JetBrains)
- Auto-approve settings
- pip vs pipx configurations
- Configuration templates
- Troubleshooting
See the IDE Integration Guide
Environment Variables
Optional environment variables for enhanced functionality:
# API Keys (optional, for higher rate limits)
export GITHUB_TOKEN="your_github_token"
export NVD_API_KEY="your_nvd_api_key"
# Tool paths (optional, only if tools are not in PATH)
# Tools are auto-detected by default using shutil.which()
export PURL2NOTICES_PATH="/custom/path/to/purl2notices"
export OSSLILI_PATH="/custom/path/to/osslili"
export BINARYSNIFFER_PATH="/custom/path/to/binarysniffer"
export VULNQ_PATH="/custom/path/to/vulnq"
export OSPAC_PATH="/custom/path/to/ospac"
export UPMEX_PATH="/custom/path/to/upmex"
Note: Tools are automatically detected in your PATH. Environment variables are only needed for custom installation locations.
Usage Examples
With MCP Clients
Once configured, you can ask your LLM:
- "Scan /path/to/project for license compliance issues"
- "Analyze this Android APK file for OSS components and licenses"
- "Check if this project has any critical vulnerabilities"
- "Generate an SBOM for my project"
- "What licenses are in this compiled binary?"
- "Validate these licenses against our commercial distribution policy"
- "Find all GPL-licensed dependencies in this codebase"
Workflows
License Compliance Check
- Scan the project to identify all packages and licenses
- Load or create a policy defining allowed/denied licenses
- Validate licenses against the policy
- Generate compliance report with violations and recommendations
Vulnerability Assessment
- Discover packages in the codebase
- Query vulnerability databases for each package
- Prioritize by severity (CRITICAL > HIGH > MEDIUM > LOW)
- Identify available fixes and upgrade paths
- Generate security report with remediation steps
SBOM Generation
- Scan project structure to identify components
- Extract metadata for each component
- Detect licenses and copyright information
- Format as SBOM (CycloneDX 1.4 JSON)
- Validate completeness of the SBOM
Examples
Basic MCP Client Usage
See examples/basic_usage.py for simple examples of calling MCP tools directly.
Strands Agent with Ollama
A complete autonomous agent example demonstrating OSS compliance analysis using local LLM (Ollama) with MCP integration.
Location: examples/strands-agent-ollama/
Features:
- Autonomous decision-making (plan → execute → interpret → report)
- Local LLM inference via Ollama (llama3, gemma3, deepseek-r1)
- Interactive and batch analysis modes
- Custom policy enforcement
- Complete privacy (no external API calls)
Quick Start:
cd examples/strands-agent-ollama
./quickstart.sh
python agent.py interactive
Documentation:
- README.md - Complete usage guide
- TUNING.md - Optimization guide
- OVERVIEW.md - Architecture reference
Use Cases:
- Mobile app compliance (APK/IPA analysis)
- Embedded/IoT firmware scanning
- CI/CD integration
- Interactive compliance queries
See the example directory for full details.
Contributing
We welcome contributions! Please see CONTRIBUTING.md for details.
License
mcp-semclone is released under the Apache License 2.0. See LICENSE for details.
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: Report vulnerabilities to security@semcl.one
Part of the SEMCL.ONE Software Composition Analysis toolchain
Preguntas sobre SEMCL.ONE MCP
¿Qué herramientas proporciona SEMCL.ONE MCP?
Expone 14 herramientas, incluidas scan_directory, scan_binary, check_package, download_and_scan_package, generate_legal_notices.
¿Qué tipo de binarios se pueden analizar?
El servidor puede analizar binarios compilados, incluyendo archivos APK, EXE, DLL, SO y JAR, para identificar componentes de OSS y licencias.
¿Puede generar un SBOM?
Sí, puede generar un Software Bill of Materials en formato CycloneDX.
¿Cómo instalo el servidor?
Puedes instalarlo usando un único comando: pip install mcp-semclone.
¿Soporta la validación de políticas?
Sí, permite validar licencias frente a las políticas de una organización y comprobar la compatibilidad de las licencias.