Simple Files Vectorstore

@lishenxydlgzs/simple-files-vectorstore

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de búsqueda semántica en archivos. Este servidor observa directorios específicos y crea incrustaciones vectoriales del contenido de los archivos, lo que permite la búsqueda semántica en sus documentos.

Instalación y uso

Agregue a su archivo de configuración de MCP:

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

Ubicaciones de los archivos de configuración de MCP:

• Extensión Cline de VSCode: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Aplicación de escritorio de Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuración

El servidor requiere configuración a través de variables de entorno:

Variables de entorno requeridas

Debe especificar los directorios a observar utilizando UNO de los siguientes métodos:

• WATCH_DIRECTORIES: Lista de directorios separados por comas para observar
• WATCH_CONFIG_FILE: Ruta a un archivo de configuración JSON con un arreglo watchList

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

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

El archivo de configuración de observación debe tener la siguiente estructura:

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

Variables de entorno opcionales

• CHUNK_SIZE: Tamaño de los fragmentos de texto para el procesamiento (predeterminado: 1000)
• CHUNK_OVERLAP: Superposición entre fragmentos (predeterminado: 200)
• IGNORE_FILE: Ruta a un archivo de estilo .gitignore para excluir archivos/directorios según patrones

Ejemplo con todos los parámetros opcionales:

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

Herramientas MCP

Este servidor proporciona las siguientes herramientas MCP:

1. search

Realiza búsqueda semántica en los archivos indexados.

Parámetros:

• query (requerido): La cadena de consulta de búsqueda
• limit (opcional): Número máximo de resultados a devolver (predeterminado: 5, máximo: 20)

Ejemplo de respuesta:

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

2. get_stats

Obtiene estadísticas sobre los archivos indexados.

Parámetros: Ninguno

Ejemplo de respuesta:

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

Características

• Observación e indexación de archivos en tiempo real
• Búsqueda semántica mediante incrustaciones vectoriales
• Soporte para múltiples tipos de archivos
• Tamaño de fragmento y superposición configurables
• Procesamiento de archivos en segundo plano
• Manejo automático de cambios y eliminaciones de archivos

Repositorio

Repositorio de GitHub