Waybackurls MCP
Waybackurls MCP 是连接 Waybackurls（一种从 Wayback Machine 检索历史 URL 的工具）与模型上下文协议 (MCP) 生态系统的桥梁。
概述
Waybackurls MCP 可将 Waybackurls 的历史端点发现功能无缝集成到兼容 MCP 的应用程序和 AI 驱动的工作流系统中。借助此桥梁，您可以利用互联网档案馆的 Wayback Machine，通过标准化协议查找被遗忘的 API 路径、旧端点以及潜在的易受攻击 URL，从而更轻松地将其集成到自动化安全测试流程或 AI 助手功能中。
特征
- 与 Waybackurls 集成，从 Wayback Machine 获取历史 URL
- 在搜索中包含或排除子域名的选项
- 简单的配置和设置
- 轻松与其他 MCP 兼容工具和系统集成
- 标准化输入/输出处理
安装
先决条件
- Node.js（v16 或更高版本）
- 您的系统上已安装 Waybackurls
安装
# Install globally
npm install -g gc-waybackurls-mcp
# Or run directly without installing
npx gc-waybackurls-mcp
配置
该服务器需要通过WAYBACKURLS_PATH环境变量设置 Waybackurls 可执行文件的路径。
例子：
# Linux/macOS
export WAYBACKURLS_PATH=/usr/local/bin/waybackurls
# Windows
set WAYBACKURLS_PATH=C:\path\to\waybackurls\waybackurls.exe
用法
命令行
# With WAYBACKURLS_PATH environment variable set
npx gc-waybackurls-mcp
使用 Claude Desktop
添加到您的claude_desktop_config.json ：
{
"mcpServers": {
"waybackurls": {
"command": "npx",
"args": ["-y", "gc-waybackurls-mcp"],
"env": {
"WAYBACKURLS_PATH": "C:\\path\\to\\waybackurls\\waybackurls.exe"
}
}
}
}
与其他 MCP 客户端
对于其他 MCP 客户端，您可以配置它们以使用此服务器：
WAYBACKURLS_PATH=/path/to/waybackurls npx gc-waybackurls-mcp
运行 Waybackurls
配置完成后，您可以使用do-waybackurls工具通过 MCP 界面运行 Waybackurls：
// Example of calling Waybackurls through MCP for a domain including subdomains
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: false
});
// Example of calling Waybackurls through MCP for a domain excluding subdomains
const resultNoSubs = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: true
});
参数
Waybackurls MCP 支持以下参数：
target ：检索历史 URL 的域（必需）noSub ：布尔标志，用于控制是否应包含子域（默认值：false）
示例
收集所有历史 URL
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: false
});
仅收集主域名的历史 URL
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: true
});
进一步分析的过程结果
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com"
});
// Split the results into individual URLs
const urls = result.content[0].text.trim().split('\n');
// Filter for specific file types or patterns
const jsFiles = urls.filter(url => url.endsWith('.js'));
const apiEndpoints = urls.filter(url => url.includes('/api/'));
与人工智能助手集成
Waybackurls MCP 旨在与支持模型上下文协议的 AI 助手无缝协作，实现安全测试和侦察任务的自然语言交互。
与人工智能助手的对话示例：
User: Find historical URLs for example.com
AI: I'll retrieve historical URLs for example.com using the Wayback Machine.
[AI uses Waybackurls MCP to fetch the URLs and returns the results]
I found the following interesting historical endpoints for example.com:
- Several old API endpoints: /api/v1/users, /api/v2/products
- Previously accessible admin pages: /admin/dashboard, /admin/users
- Backup files: /backup/db.sql, /backup/config.old
...
安全注意事项
- 此工具旨在用于合法的安全研究和测试
- 扫描网站前务必获得适当的授权
- 负责任地、合乎道德地使用
- 该工具仅检索互联网档案馆已公开存档的信息
故障排除
如果您遇到问题：
- 验证 Waybackurls 是否已正确安装且可访问
- 检查配置中 Waybackurls 可执行文件的路径
- 确保设置适当的执行权限
- 查看服务器日志以获取详细的错误消息
- 某些域名在 Wayback Machine 中的历史记录可能有限或没有
使用技巧
- 将 Waybackurls 结果与其他侦察工具相结合，获取更全面的目标信息
- 过滤结果以关注感兴趣的特定文件类型或目录
- 在历史 URL 中寻找可能表明已放弃的功能或测试端点的模式
- 使用结果来指导您的安全测试或漏洞赏金狩猎
执照
Apache-2.0
致谢