local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports .gitignore-style file exclusion patterns through the IGNORE_FILE configuration to control which files are indexed.
Supports indexing and searching Markdown files, allowing semantic queries across Markdown document content.

@lishenxydlgzs/심플파일벡터스토어

파일 전반에 걸쳐 의미론적 검색 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 지정된 디렉터리를 감시하고 파일 내용의 벡터 임베딩을 생성하여 문서 전반에 걸쳐 의미론적 검색을 지원합니다.

설치 및 사용

MCP 설정 파일에 다음을 추가합니다.

지엑스피1

MCP 설정 파일 위치:

VSCode Cline 확장 프로그램: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Claude 데스크톱 앱: ~/Library/Application Support/Claude/claude_desktop_config.json

구성

서버를 구성하려면 환경 변수가 필요합니다.

필수 환경 변수

다음 방법 중 하나를 사용하여 감시할 디렉토리를 지정해야 합니다.

WATCH_DIRECTORIES : 감시할 디렉토리의 쉼표로 구분된 목록
WATCH_CONFIG_FILE : watchList 배열이 있는 JSON 구성 파일의 경로

WATCH_DIRECTORIES를 사용한 예:

{
  "mcpServers": {
    "files-vectorstore": {
      "command": "npx",
      "args": [
        "-y",
        "@lishenxydlgzs/simple-files-vectorstore"
      ],
      "env": {
        "WATCH_DIRECTORIES": "/path/to/dir1,/path/to/dir2"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

WATCH_CONFIG_FILE을 사용한 예:

{
  "mcpServers": {
    "files-vectorstore": {
      "command": "npx",
      "args": [
        "-y",
        "@lishenxydlgzs/simple-files-vectorstore"
      ],
      "env": {
        "WATCH_CONFIG_FILE": "/path/to/watch-config.json"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

watch 구성 파일은 다음과 같은 구조를 가져야 합니다.

{
  "watchList": [
    "/path/to/dir1",
    "/path/to/dir2",
    "/path/to/specific/file.txt"
  ]
}

선택적 환경 변수

CHUNK_SIZE : 처리할 텍스트 청크의 크기(기본값: 1000)
CHUNK_OVERLAP : 청크 간 겹침(기본값: 200)
IGNORE_FILE : 패턴에 따라 파일/디렉토리를 제외하기 위한 .gitignore 스타일 파일의 경로

모든 선택적 매개변수를 포함한 예:

  {
    "mcpServers": {
      "files-vectorstore": {
        "command": "npx",
        "args": [
          "-y",
          "@lishenxydlgzs/simple-files-vectorstore"
        ],
        "env": {
          "WATCH_DIRECTORIES": "/path/to/dir1,/path/to/dir2",
          "CHUNK_SIZE": "2000",
          "CHUNK_OVERLAP": "500",
          "IGNORE_FILE": "/path/to/.gitignore"
        },
        "disabled": false,
        "autoApprove": []
      }
    }
  }

MCP 도구

이 서버는 다음과 같은 MCP 도구를 제공합니다.

1. 검색

인덱스된 파일 전반에 걸쳐 의미 검색을 수행합니다.

매개변수:

query (필수): 검색 쿼리 문자열
limit (선택 사항): 반환할 최대 결과 수(기본값: 5, 최대값: 20)

응답 예시:

[
  {
    "content": "matched text content",
    "source": "/path/to/file",
    "fileType": "markdown",
    "score": 0.85
  }
]

2. 통계 가져오기

인덱스된 파일에 대한 통계를 가져옵니다.

매개변수: 없음

응답 예시:

{
  "totalDocuments": 42,
  "watchedDirectories": ["/path/to/docs"],
  "processingFiles": []
}

특징

실시간 파일 감시 및 인덱싱
벡터 임베딩을 사용한 의미 검색
다양한 파일 유형 지원
구성 가능한 청크 크기 및 오버랩
파일의 백그라운드 처리
파일 변경 및 삭제 자동 처리

저장소

GitHub 저장소

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

디렉토리 목록을 감시하고 디렉토리에 있는 모든 마크다운, HTML, 텍스트 파일을 자동으로 벡터 스토어에 색인하여 컨텍스트를 강화하는 기능을 제공하는 매우 간단한 벡터 스토어입니다.

Related Resources

Reddit Discussion about this server

Simple Files Vector Store Server