ARL MCP Server

A Model Context Protocol (MCP) server for ARL platform integration.

简介

ARL MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，用于与 ARL (Asset Reconnaissance Lighthouse) 平台集成。它提供了一系列工具函数，可以通过 MCP 协议调用 ARL 平台的各种功能。

功能特性

域名提取: 从 HTTP 数据包中提取主域名
任务管理: 创建和查询 ARL 平台扫描任务
子域名枚举: 获取指定域名的所有子域名
IP 地址发现: 获取域名对应的 IP 地址列表
站点识别: 获取域名下的所有站点地址
文件泄露检测: 发现潜在的文件泄露链接
节流控制: 内置休眠功能，避免过快轮询

安装

使用 uvx (推荐)

# 直接运行（无需安装）
uvx arl-mcp

# 从 GitHub 运行
uvx --from git+https://github.com/WACHI/arl-mcp.git arl-mcp

# 从本地路径运行
uvx --from ./dist/arl_mcp-0.1.0-py3-none-any.whl arl-mcp

使用 pip

pip install arl-mcp

使用方法

启动服务器

arl-mcp

可用工具函数

extract_main_domain(packet: str): 从 HTTP 数据包中提取主域名
extract_domain_or_ip(text: str): 从文本中提取域名或 IP
sleep_for(seconds: int): 休眠指定秒数
add_scan_task(...): 创建 ARL 扫描任务
query_task_status(name: str): 查询任务状态
get_all_subdomains(domain: str): 获取子域名列表
query_ip_list(domain: str): 获取 IP 地址列表
query_site_list(domain: str): 获取站点列表
query_fileleak_list(domain: str): 获取文件泄露链接

配置要求

Python 3.8+
ARL 平台访问权限
有效的 ARL API Token

开发

本地开发安装

git clone https://github.com/WACHI/arl-mcp.git
cd arl-mcp
pip install -e .

运行测试

pytest

构建包

python -m build

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

注意事项

⚠️ 安全提醒:

请确保 API Token 的安全性
不要在公开代码中暴露敏感信息
建议在生产环境中使用环境变量管理配置

联系方式

如有问题或建议，请通过 GitHub Issues 联系我们。

Metadata

Release files for arl-mcp 0.1.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for arl-mcp 0.1.13
File	Size	Uploaded	Provenance
arl_mcp-0.1.13.tar.gz	23.0 MB	Jul 22, 2025	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for arl-mcp 0.1.13
File	Interpreter	ABI	Platform	Reset
arl_mcp-0.1.13-py3-none-any.whl 8.2 kB Jul 22, 2025 Without provenance	Python 3	none	any	Details

Total release size: 23.1 MB

Release files / arl_mcp-0.1.13.tar.gz

Download URL	arl_mcp-0.1.13.tar.gz
Size	23.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`954424e87f222adc3c177edaccc46a8551e3a0c69e1abea932b188820f9ecb04`
BLAKE2b-256 checksum How to use checksums	`c1f6ef7218b597120d2c5ef0df36087bc7d5f63d2aec6f3f1782b3f4d9226062`
Upload date	Jul 22, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.6.4`

Release files / arl_mcp-0.1.13-py3-none-any.whl

Download URL	arl_mcp-0.1.13-py3-none-any.whl
Size	8.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`01a571b3ca8a54542813c4bf128308771780bf2cff7be5ad784f81834ab9ce4a`
BLAKE2b-256 checksum How to use checksums	`cb9220712cd830bebdea87fa35fe4f1f6d08339caeae42b81b872441fdf6b896`
Upload date	Jul 22, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.6.4`

Security for arl-mcp 0.1.13

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.