Sec MCP

sec-mcp is a Python security detection toolkit that provides security check functions for domains, URLs, IPs, etc. It supports integration with Python applications, use in the terminal CLI, or running as an MCP server to provide real-time threat insights for LLMs.

Security Artificial intelligence chatbots #Security Detection #Blacklist Check #Real-time Threat #LLM Integration .Python

rating : 2 points

downloads : 6.6K

update time : 2025-04-29

Open Site

sec-mcp - Security Context Information Query Protocol Tool

🚀 sec-mcp Usage Guide

sec-mcp is a tool for network security monitoring and threat detection, developed by Montimage. It offers various functions, including blacklist database management, batch checking the security of URLs or IP addresses, and integration into AI-driven clients via API or MCP servers.

🚀 Quick Start

Installation Steps

Create a Virtual Environment

Create a virtual environment:
```
python3.12 -m venv .venv
```

Activate the virtual environment:

source .venv/bin/activate  # For macOS/Linux
Or
.venv\Scripts\activate  # For Windows

Install sec-mcp:
```
pip install sec-mcp
```

✨ Features

Use as a Tool

Verify status:
```
sec-mcp status
```
Update the blacklist database:
```
sec-mcp update
```
Batch check content in a file:
```
sec-mcp batch urls.txt
```

Use via API

Import the module and initialize:

from sec_mcp import SecMCP

client = SecMCP()

Update the database:
```
client.update()
```

Single check:

result = client.check("https://example.com")
print(result.to_json())

Batch check:

urls = ["https://example.com", "https://test.com"]
results = client.check_batch(urls)
for r in results:
    print(r.to_json())

Use as an MCP Server

Configure the MCP client: Add the following content to the client's configuration file:

{
  "mcpServers": {
    "sec-mcp": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "sec_mcp.start_server"]
    }
  }
}

Important Note:
- Use the absolute path of the Python executable in the virtual environment.
- For Windows systems, the path might be similar to: C:\path\to\.venv\Scripts\python.exe

🆕 New Features

RPC Endpoints

check_batch(values: List[str]): Batch check multiple domain names, URLs, or IP addresses. Returns a list containing { value, is_safe, explanation }.
sample_blacklist(count: int): Returns a random sample of blacklist entries, with the number determined by the specified parameter.
get_source_stats(): Get detailed statistical information, including the total number of entries, the count for each data source, and the last update timestamp.
get_update_history(source?: str, start?: str, end?: str): Get the update history, which can be filtered by source or time period.
flush_cache(): Clear the URL/IP cache in memory. Returns { cleared: bool }.
health_check(): Perform a health check on the database and scheduler. Returns { db_ok: bool, scheduler_alive: bool, last_update: timestamp }.
add_entry(url: str, ip?: str, date?: str, score?: float, source?: str): Manually add a blacklist entry. Returns { success: bool }.
remove_entry(value: str): Remove a specific blacklist entry based on the URL or IP address. Returns { success: bool }.

⚙️ Configuration Options

Configuration can be done through the config.json file:

Property	Details
blacklist_sources	Addresses of blacklist data sources
batch_size	Batch processing size
api_timeout	API request timeout in seconds

📋 Example Configuration

{
  "blacklist_sources": [
    "https://example.com/blacklist.txt",
    "http://another-source.net/list"
  ],
  "batch_size": 100,
  "api_timeout": 30
}

🏢 Company Information

Montimage

Address: Paris, France
Website: https://www.montimage.com
Support Email: support@montimage.com

📄 License

sec-mcp is open-source software licensed under the MIT License. To view the full license information, visit: https://github.com/montimage/sec-mcp/blob/main/LICENSE