웨이백URL MCP
Waybackurls MCP는 Wayback Machine에서 과거 URL을 검색하는 도구인 Waybackurls와 Model Context Protocol(MCP) 생태계를 연결하는 브리지입니다.
개요
Waybackurls MCP는 Waybackurls의 과거 엔드포인트를 검색하는 기능을 MCP 호환 애플리케이션 및 AI 기반 워크플로 시스템에 원활하게 통합할 수 있도록 지원합니다. 이 브릿지를 통해 인터넷 아카이브의 Wayback Machine을 활용하여 표준화된 프로토콜을 통해 잊혀진 API 경로, 이전 엔드포인트, 그리고 잠재적으로 취약한 URL을 찾아낼 수 있으며, 자동화된 보안 테스트 파이프라인이나 AI 지원 기능에 쉽게 통합할 수 있습니다.
특징
- Wayback Machine에서 과거 URL을 가져오기 위해 Waybackurls와 통합
- 검색에 하위 도메인을 포함하거나 제외하는 옵션
- 간단한 구성 및 설정
- 다른 MCP 호환 도구 및 시스템과의 쉬운 통합
- 표준화된 입출력 처리
설치
필수 조건
- Node.js(v16 이상)
- 시스템에 Waybackurls가 설치되었습니다
설치
지엑스피1
구성
이 서버에서는 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_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/'));
AI 어시스턴트와의 통합
Waybackurls MCP는 모델 컨텍스트 프로토콜을 지원하는 AI 어시스턴트와 원활하게 작동하도록 설계되어 보안 테스트 및 정찰 작업을 위한 자연어 상호작용을 가능하게 합니다.
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의 패턴을 찾아보세요.
- 결과를 사용하여 보안 테스트 또는 버그 현상금 사냥에 대한 정보를 얻으세요.
특허
아파치-2.0
감사의 말