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 联系我们。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
arl_mcp-0.1.13.tar.gz
(23.0 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file arl_mcp-0.1.13.tar.gz.
File metadata
- Download URL: arl_mcp-0.1.13.tar.gz
- Upload date:
- Size: 23.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.6.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
954424e87f222adc3c177edaccc46a8551e3a0c69e1abea932b188820f9ecb04
|
|
| MD5 |
2f8dddd3b0dca5d533db0594a9b7d9ff
|
|
| BLAKE2b-256 |
c1f6ef7218b597120d2c5ef0df36087bc7d5f63d2aec6f3f1782b3f4d9226062
|
File details
Details for the file arl_mcp-0.1.13-py3-none-any.whl.
File metadata
- Download URL: arl_mcp-0.1.13-py3-none-any.whl
- Upload date:
- Size: 8.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.6.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
01a571b3ca8a54542813c4bf128308771780bf2cff7be5ad784f81834ab9ce4a
|
|
| MD5 |
184c860571ec3d5c8d3e15eceb49e3ba
|
|
| BLAKE2b-256 |
cb9220712cd830bebdea87fa35fe4f1f6d08339caeae42b81b872441fdf6b896
|
