모든 검색 MCP 서버
Windows, macOS, Linux에서 빠른 파일 검색 기능을 제공하는 MCP 서버입니다. Windows에서는 Everything SDK를 사용하고, macOS에서는 내장된 mdfind 명령을 사용하며, Linux에서는 locate / plocate 명령을 사용합니다.
도구
찾다
시스템 전체에서 파일과 폴더를 검색하세요. 검색 기능과 구문 지원은 플랫폼마다 다릅니다.
Windows: 전체 Everything SDK 기능(아래 구문 가이드 참조)
macOS: Spotlight 데이터베이스를 사용한 기본 파일 이름 및 콘텐츠 검색
Linux: Locate 데이터베이스를 사용한 기본 파일 이름 검색
매개변수:
query(필수): 검색 쿼리 문자열입니다. 아래 플랫폼별 참고 사항을 참조하세요.max_results(선택 사항): 반환할 최대 결과 수(기본값: 100, 최대값: 1000)match_path(선택 사항): 파일 이름만이 아닌 전체 경로에 대해 일치(기본값: false)match_case(선택 사항): 대소문자 구분 검색을 활성화합니다(기본값: false)match_whole_word(선택 사항): 전체 단어만 일치(기본값: false)match_regex(선택 사항): 정규식 검색을 활성화합니다(기본값: false)sort_by(선택 사항): 결과의 정렬 순서입니다(기본값: 1). 사용 가능한 옵션은 다음과 같습니다.
지엑스피1
예:
{
"query": "*.py",
"max_results": 50,
"sort_by": 6
}{
"query": "ext:py datemodified:today",
"max_results": 10
}응답에는 다음이 포함됩니다.
파일/폴더 경로
파일 크기(바이트)
마지막 수정 날짜
검색 구문 가이드
각 플랫폼(Windows, macOS, Linux)에서 지원되는 검색 구문에 대한 자세한 내용은 SEARCH_SYNTAX.md를 참조하세요.
Related MCP server: MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool
필수 조건
윈도우
모든 것을 검색하는 유틸리티:
https://www.voidtools.com/ 에서 다운로드하고 설치하세요
Everything 서비스가 실행 중인지 확인하세요
모든 SDK:
https://www.voidtools.com/support/everything/sdk/ 에서 다운로드하세요
SDK 파일을 시스템의 위치로 추출합니다.
리눅스
locate또는plocate명령을 설치하고 초기화합니다.Ubuntu/Debian:
sudo apt-get install plocate또는sudo apt-get install mlocateFedora:
sudo dnf install mlocate
설치 후 데이터베이스를 업데이트하세요.
plocate의 경우:
sudo updatedbmlocate의 경우:
sudo /etc/cron.daily/mlocate
맥OS
추가 설정이 필요하지 않습니다. 서버는 내장된 mdfind 명령을 사용합니다.
설치
Smithery를 통해 설치
Everything Search for Claude Desktop을 자동으로 설치하려면 Smithery를 이용하세요.
npx -y @smithery/cli install mcp-server-everything-search --client claudeuv 사용(권장)
uv 사용하면 별도의 설치가 필요하지 않습니다. uvx 사용하여 mcp-server-everything-search를 직접 실행합니다.
PIP 사용
또는 pip를 통해 mcp-server-everything-search 설치할 수 있습니다.
pip install mcp-server-everything-search설치 후 다음을 사용하여 스크립트로 실행할 수 있습니다.
python -m mcp_server_everything_search구성
윈도우
서버에서는 Everything SDK DLL을 사용할 수 있어야 합니다.
환경 변수:
EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dll리눅스와 macOS
추가 구성이 필요하지 않습니다.
Claude Desktop과 함께 사용
플랫폼에 따라 다음 구성 중 하나를 claude_desktop_config.json 에 추가하세요.
"mcpServers": {
"everything-search": {
"command": "uvx",
"args": ["mcp-server-everything-search"],
"env": {
"EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
}
}
}"mcpServers": {
"everything-search": {
"command": "python",
"args": ["-m", "mcp_server_everything_search"],
"env": {
"EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
}
}
}"mcpServers": {
"everything-search": {
"command": "uvx",
"args": ["mcp-server-everything-search"]
}
}또는 pip 설치를 사용하는 경우:
"mcpServers": {
"everything-search": {
"command": "python",
"args": ["-m", "mcp_server_everything_search"]
}
}디버깅
MCP 검사기를 사용하여 서버를 디버깅할 수 있습니다. UVX 설치의 경우:
npx @modelcontextprotocol/inspector uvx mcp-server-everything-search또는 특정 디렉토리에 패키지를 설치했거나 해당 디렉토리에서 개발 중인 경우:
git clone https://github.com/mamertofabian/mcp-everything-search.git
cd mcp-everything-search/src/mcp_server_everything_search
npx @modelcontextprotocol/inspector uv run mcp-server-everything-search서버 로그를 보려면:
리눅스/macOS:
tail -f ~/.config/Claude/logs/mcp*.log윈도우(PowerShell):
Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait개발
로컬 개발을 수행하는 경우 변경 사항을 테스트하는 방법은 두 가지가 있습니다.
MCP 검사기를 실행하여 변경 사항을 테스트하세요. 실행 지침은 디버깅을 참조하세요.
Claude 데스크톱 앱을 사용하여 테스트해 보세요.
claude_desktop_config.json파일에 다음을 추가하세요.
"everything-search": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-everything-search/src/mcp_server_everything_search",
"run",
"mcp-server-everything-search"
],
"env": {
"EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
}
}특허
이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.
부인 성명
이 프로젝트는 voidtools(Everything 검색 유틸리티 개발사)와 제휴, 보증 또는 후원 관계가 없습니다. 공개적으로 사용 가능한 Everything SDK를 활용하는 독립적인 프로젝트입니다.