Skip to main content
Glama
lishenxydlgzs

Simple Files Vector Store Server

@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

Related MCP server: MCP Document Indexer

구성

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

필수 환경 변수

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

  • 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 저장소

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides advanced document search and processing capabilities through vector stores, including PDF processing, semantic search, web search integration, and file operations. Enables users to create searchable document collections and retrieve relevant information using natural language queries.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables real-time indexing and semantic search of local documents (PDF, Word, text, Markdown, RTF) using vector embeddings and local LLMs. Monitors folders for changes and provides natural language search capabilities through Claude Desktop integration.
    21
    MIT
  • F
    license
    B
    quality
    D
    maintenance
    Provides intelligent retrieval capabilities for local files by scanning directories, generating vector indexes, and enabling semantic search through RAG (Retrieval Augmented Generation) with incremental indexing support.
    2
    -