Skip to main content
Glama
mamertofabian

mcp-everything-search

모든 검색 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

필수 조건

윈도우

  1. 모든 것을 검색하는 유틸리티:

  2. 모든 SDK:

리눅스

  1. locate 또는 plocate 명령을 설치하고 초기화합니다.

    • Ubuntu/Debian: sudo apt-get install plocate 또는 sudo apt-get install mlocate

    • Fedora: sudo dnf install mlocate

  2. 설치 후 데이터베이스를 업데이트하세요.

    • plocate의 경우: sudo updatedb

    • mlocate의 경우: sudo /etc/cron.daily/mlocate

맥OS

추가 설정이 필요하지 않습니다. 서버는 내장된 mdfind 명령을 사용합니다.

설치

Smithery를 통해 설치

Everything Search for Claude Desktop을 자동으로 설치하려면 Smithery를 이용하세요.

npx -y @smithery/cli install mcp-server-everything-search --client claude

uv 사용(권장)

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

개발

로컬 개발을 수행하는 경우 변경 사항을 테스트하는 방법은 두 가지가 있습니다.

  1. MCP 검사기를 실행하여 변경 사항을 테스트하세요. 실행 지침은 디버깅을 참조하세요.

  2. 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를 활용하는 독립적인 프로젝트입니다.

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mamertofabian/mcp-everything-search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server