SkillAgentSearch skills...

aliensec-mcp-server

šŸ‘½ The AlienSec MCP Server is an AlienVault OTX endpoint security scanning MCP server with VirusTotal integration.

Install / Use

claude mcp add VRIL-LABS -- npx -y github:VRIL-LABS/aliensec-mcp-server

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
šŸ”Œ

MCP Server

Model Context Protocol server

Quality Score

80/100

Category

Security

Supported Platforms

Claude Code
Claude Desktop

Our assessment of aliensec-mcp-server

aliensec-mcp-server scores 80/100 on our quality scale, 997th of 1,108 Security skills we index.

Its MCP Server is 21 KB long, well organised into 97 sections with 33 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so aliensec-mcp-server is actively maintained.
  • Our last check on 2026-09-23 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

aliensec-mcp-server compared with similar skills

All 4 of these similar skills score higher than aliensec-mcp-server; compare them before choosing.

SkillScoreStarsUpdatedFormat
aliensec-mcp-server (this skill)by VRIL-LABS803todayMCP Server
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install aliensec-mcp-server?
Run claude mcp add VRIL-LABS -- npx -y github:VRIL-LABS/aliensec-mcp-server. The install tabs above show the steps for each supported agent.
Which AI agents does aliensec-mcp-server work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is aliensec-mcp-server safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is aliensec-mcp-server still maintained?
The repository was last updated today, so aliensec-mcp-server is actively maintained.
<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/header.svg"> <img alt="AlienSec MCP Server - Security Scanning Header" src="assets/header.svg" width="100%"> </picture> </div>

AlienSec MCP Server

Production-Ready AlienVault OTX Endpoint Security Scanning MCP Server with VirusTotal Integration

License: MIT Node.js TypeScript MCP M8ven Verified M8ven Score

<sub>// crafted for the security community — funding keeps it maintained</sub>

GitHub Sponsors Open Collective Ko-fi Buy Me a Coffee thanks.dev


Overview

The AlienSec MCP Server is a production-grade Model Context Protocol (MCP) server that provides comprehensive endpoint security scanning capabilities using AlienVault OTX with optional VirusTotal integration.

This server enables AI agents and applications to perform security scans on various endpoint types (macOS PKG, Windows PowerShell, Debian APT, Redhat RPM) and retrieve threat intelligence from AlienVault OTX and VirusTotal APIs.


Features

Core Capabilities

  • Multi-Platform Endpoint Scanning

    • Scan macOS systems using PKG installer flavor
    • Scan Windows endpoints via PowerShell
    • Scan Debian/Ubuntu systems using APT
    • Scan Redhat/CentOS systems using RPM
  • VirusTotal Integration

    • Scan files and URLs using VirusTotal API
    • Retrieve existing analysis results
    • Automatic rate limiting and circuit breaker protection
    • Multiple API key support (respects VirusTotal ToS)
  • Threat Intelligence

    • Search AlienVault OTX pulses
    • Retrieve pulse details and events
    • Access indicators of compromise (IoCs)
  • Data Persistence

    • SQLite database with optional encryption
    • Scan result storage with timestamps
    • API request logging
    • Circuit breaker event tracking
  • Production-Ready Features

    • Comprehensive error handling
    • Structured logging with Pino
    • Environment variable validation with Zod
    • Type-safe API schemas
    • Graceful shutdown handling

Prerequisites

System Requirements

  • Node.js: >= 22.0.0
  • npm: >= 8.0.0
  • Operating System: macOS, Linux, or Windows
  • Disk Space: Minimum 100MB for dependencies

API Keys Required

  1. AlienVault OTX API Key (Required)

  2. VirusTotal API Key (Optional, for enhanced functionality)

    • Sign up at https://www.virustotal.com
    • Navigate to API Console
    • Generate API key(s)
    • Note: Free tier allows 500 requests/day, 4 requests/minute

Installation

Option A: Run via npx (Recommended)

aliensec-mcp-server is published to the npm registry, so you can run it directly with npx — no clone or build required:

npx -y aliensec-mcp-server

The server communicates over stdio, so you'll normally register it with an MCP client (see Using with MCP Clients) rather than running it standalone. Set ALIENVAULT_API_KEY (and optionally VIRUSTOTAL_API_KEYS) in the client configuration, as shown in each client's snippet below.

Option B: From Source (Contributors)

1. Clone the Repository

git clone https://github.com/VRIL-LABS/aliensec-mcp-server.git
cd aliensec-mcp-server

2. Install Dependencies

npm install

This will install all production and development dependencies.

3. Configure Environment Variables

Copy the example environment file and update with your API keys:

cp .env.example .env

Edit .env with your API keys:

# Server Configuration
NAME=aliensec-mcp-server
VERSION=1.0.0
DEBUG=false
LOG_LEVEL=info

# AlienVault OTX Configuration (Required)
ALIENVAULT_API_KEY=your_alienvault_api_key_here
ALIENVAULT_BASE_URL=https://api.agent.otxb.io
ALIENVAULT_DEFAULT_REGION=us-east-1

# VirusTotal Configuration (Optional)
VIRUSTOTAL_API_KEYS=key1,key2,key3
VIRUSTOTAL_BASE_URL=https://www.virustotal.com/api/v3
VIRUSTOTAL_RATE_LIMIT_PER_MINUTE=4
VIRUSTOTAL_DAILY_LIMIT=500
VIRUSTOTAL_CIRCUIT_BREAKER_TIMEOUT=300

# Database Configuration
DATABASE_PATH=./data/aliensec.db
DATABASE_ENCRYPTION_KEY=your_encryption_key_here
DATABASE_TIMEOUT=5000

Note: VirusTotal ToS prohibits using multiple API keys to bypass rate limits. This implementation respects those limits and uses multiple keys for redundancy only.

4. (Optional) Install SQLite Encryption Dependencies

For encrypted database support on Linux/macOS:

# Ubuntu/Debian
sudo apt-get install build-essential

# macOS
xcode-select --install

Usage

Development Mode

Run the server in development mode with automatic reloading:

npm run dev

Production Mode

Build and run the server:

npm run build
npm start

Using with MCP Clients

The server communicates via stdio (standard input/output). Because it's published to npm, you can register it with any MCP client using npx -y aliensec-mcp-server — no local clone or build required.

Below are copy-pasteable registration snippets for the major MCP clients. Replace your_key_here / key1,key2 with your actual API keys. ALIENVAULT_API_KEY is required; VIRUSTOTAL_API_KEYS is optional.

Claude Code (CLI)

claude mcp add aliensec --env ALIENVAULT_API_KEY=your_key_here --env VIRUSTOTAL_API_KEYS=key1,key2 -- npx -y aliensec-mcp-server

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aliensec": {
      "command": "npx",
      "args": ["-y", "aliensec-mcp-server"],
      "env": {
        "ALIENVAULT_API_KEY": "your_key_here",
        "VIRUSTOTAL_API_KEYS": "key1,key2"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json (workspace) or your user mcp.json:

{
  "servers": {
    "aliensec": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "aliensec-mcp-server"],
      "env": {
        "ALIENVAULT_API_KEY": "${input:alienvault_api_key}",
        "VIRUSTOTAL_API_KEYS": "${input:virustotal_api_keys}"
      }
    }
  },
  "inputs": [
    {
      "id": "alienvault_api_key",
      "type": "promptString",
      "description": "AlienVault OTX API key",
      "password": true
    },
    {
      "id": "virustotal_api_keys",
      "type": "promptString",
      "description": "VirusTotal API keys (comma-separated, optional)",
      "password": true
    }
  ]
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "aliensec": {
      "command": "npx",
      "args": ["-y", "aliensec-mcp-server"],
      "env": {
        "ALIENVAULT_API_KEY": "your_key_here",
        "VIRUSTOTAL_API_KEYS": "key1,key2"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "aliensec": {
      "command": "npx",
      "args": ["-y", "aliensec-mcp-server"],
      "env": {
        "ALIENVAULT_API_KEY": "your_key_here",
        "VIRUSTOTAL_API_KEYS": "key1,key2"
      }
    }
  }
}

From Source (Contributors)

If you've cloned and built the repository locally, point your client at the built entry point instead of using npx:

# Direct execution
node dist/index.js

# Or using the npm script
npm start

Example MCP Client Integration

import { Client } from '@modelcontextprotocol/client';
import { StdioClientTransport } from '@modelcontextprotocol/client/stdio';

const client = new Client({ name: 'my-client', version: '1.0.0' });
const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', 'aliensec-mcp-server'],
});

await client.connect(transport);

// Call a scan tool
const result = await client.callTool({
  name: 'scan_macos_pkg',
  arguments: {
    target: '192.168.1.100',
    useVirusTotal: true,
  },
});

console.log(result.content);

Available Tools

Scan Tools (5)

| Tool | Description | Parameters | |------|-------------|------------| | scan_endpoint | Generic endpoint scanner | flavor, target, useVirusTotal, apiKeyIndex | | scan_macos_pkg | Scan macOS PKG installer | target, useVirusTotal | | scan_windows | Scan Windows endpoint | target, useVirusTotal | | scan_debian_apt | Scan Debian/APT endpoint | target, useVirusTotal | | scan_redhat_rpm | Scan Redhat/RPM endpoint | target, useVirusTotal |

VirusTotal Tools (2)

| Tool | Description | Parameters | |------|-------------|------------| | use_virustotal | Scan resource with VirusTotal | resource, apiKeyIndex, wait | | get_virustotal_analysis | Get existing VirusTotal analysis | hash, apiKeyIndex |

AlienVault OTX Tools (3)

| Tool | Description | Parameters | |------|-------------|------------| | get_bootstrap_command | Get bootstrap command for flavor | flavor, target | | get_bootstrap_urls | Get all bootstrap URLs | - | | search_pulses | Search AlienVault OTX pulses | query, limit, offset |

Database Tools (4)

| Tool | Description | Parameters | |------|-------------|------------| | get_scan_stats | Get scan statistics | - | | get_recent_scans | Get recent scans | limit | | get_circuit_breaker_stats | Get circuit breaker stats | - | | get_api_stats | Get API statistics | - |

System Tools (1)

| Tool | Description | Parameters | |------|-------------|------------| | get_health | Get server health status | - |


Bootstrap Commands

The server provides pre-configured bootstrap commands for each endpoint flavor. <api-key> below is your resolved ALIENVAULT_API_KEY value, and TARGET=<target> is only included when a target is provided.

macOS PKG Installer

API_KEY=<api-key> [TARGET=<target>] bash -c "$(curl -s https://api.agent.otxb.io/osquery-api-otx/bootstrap?flavor=pkg)"

Windows PowerShell

[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; API_KEY=<api-key> (new-object Net.WebClient).DownloadString("https://api.agent.otxb.io/osquery-api-otx/bootstrap?flavor=powershell") | iex; install_agent -apikey <api-key> [-target <target>]

Debian APT

API_KEY=<api-key> [TARGET=<target>] bash -c "$(curl -s https://api.agent.otxb.io/osquery-api-otx/bootstrap?flavor=apt)"

Redhat RPM

API_KEY=<api-key> [TARGET=<target>] bash -c "$(curl -s https://api.agent.otxb.io/osquery-api-otx/bootstrap?flavor=rpm)"

Project Structure

aliensec-mcp-server/
ā”œā”€ā”€ src/
│   ā”œā”€ā”€ config/
│   │   └── index.ts           # Environment configuration & validation
│   ā”œā”€ā”€ core/
│   │   ā”œā”€ā”€ alienVault.ts      # AlienVault OTX API client
│   │   └── virusTotal.ts      # VirusTotal API client
│   ā”œā”€ā”€ database/
│   │   └── index.ts           # SQLite database with repositories
│   ā”œā”€ā”€ types/
│   │  

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3
CategorySecurity
Updated11h ago
Forks0

Languages

TypeScript

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low
aliensec-mcp-server — MCP Server: Install & Safety Check | SkillAgent