Simple Files Vectorstore

@lishenxydlgzs/simple-files-vectorstore

Um servidor Model Context Protocol (MCP) que fornece capacidades de busca semântica em arquivos. Este servidor monitora diretórios especificados e cria embeddings vetoriais do conteúdo dos arquivos, permitindo busca semântica em seus documentos.

Instalação e Uso

Adicione ao seu arquivo de configurações do MCP:

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

Locais dos arquivos de configurações do MCP:

• Extensão Cline do VSCode: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Aplicativo de Desktop do Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuração

O servidor requer configuração por meio de variáveis de ambiente:

Variáveis de Ambiente Obrigatórias

Você deve especificar os diretórios a monitorar usando UM dos seguintes métodos:

• WATCH_DIRECTORIES: Lista de diretórios separados por vírgula para monitorar
• WATCH_CONFIG_FILE: Caminho para um arquivo de configuração JSON com um array watchList

Exemplo usando 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": []
    }
  }
}

Exemplo usando 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": []
    }
  }
}

O arquivo de configuração de monitoramento deve ter a seguinte estrutura:

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

Variáveis de Ambiente Opcionais

• CHUNK_SIZE: Tamanho dos blocos de texto para processamento (padrão: 1000)
• CHUNK_OVERLAP: Sobreposição entre blocos (padrão: 200)
• IGNORE_FILE: Caminho para um arquivo no estilo .gitignore para excluir arquivos/diretórios com base em padrões

Exemplo com todos os parâmetros opcionais:

  {
    "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": []
      }
    }
  }

Ferramentas MCP

Este servidor fornece as seguintes ferramentas MCP:

1. search

Realize busca semântica nos arquivos indexados.

Parâmetros:

• query (obrigatório): A string de consulta de busca
• limit (opcional): Número máximo de resultados a retornar (padrão: 5, máximo: 20)

Exemplo de resposta:

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

2. get_stats

Obtenha estatísticas sobre os arquivos indexados.

Parâmetros: Nenhum

Exemplo de resposta:

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

Recursos

• Monitoramento e indexação de arquivos em tempo real
• Busca semântica usando embeddings vetoriais
• Suporte a múltiplos tipos de arquivo
• Tamanho de bloco e sobreposição configuráveis
• Processamento de arquivos em segundo plano
• Tratamento automático de alterações e exclusões de arquivos

Repositório

Repositório GitHub