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-serverIf the server publishes to npm under a different name, use that package instead ā check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
SecuritySupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| aliensec-mcp-server (this skill)by VRIL-LABS | 80 | 3 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.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.
Skill content
View source on GitHubAlienSec MCP Server
Production-Ready AlienVault OTX Endpoint Security Scanning MCP Server with VirusTotal Integration
<sub>// crafted for the security community ā funding keeps it maintained</sub>
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
-
AlienVault OTX API Key (Required)
- Sign up at https://otx.alienvault.com
- Navigate to Settings > API Keys
- Generate a new API key
-
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
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
ruflo
81.9kš The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
