librechat-personal-files-mcp

Servidor MCP que proporciona almacenamiento personal de archivos por usuario, documentación persistente, indexación/recuperación RAG y publicación de enlaces públicos opacos para agentes de LibreChat.

Características

• Almacenamiento por usuario: Archivos privados bajo /data/private/<userId>/ con operaciones completas de CRUD, listado y movimiento.

• Catálogo de documentación: save_documentation / update_documentation escriben en docs/ y actualizan memory-index.json (esquema v2).

• Integración RAG: index_document envía contenido a rag_api mediante POST /embed con verificación canary (issue #305); search_knowledge para búsqueda semántica; remove_from_knowledge para eliminación.

• Publicación pública: publish_file crea tokens criptográficamente aleatorios (≥128 bits); los archivos se sirven mediante Nginx X-Accel-Redirect con Content-Disposition: attachment, nosniff, no-store.

• Seguridad estricta: Fail-closed ante X-User-Id ausente o no válido; bloqueo de path traversal; sin rutas absolutas; sin segmentos ..; detección de escape por symlink; protección de segmentos reservados; escrituras atómicas del índice con bloqueo entre procesos.

Related MCP server: knowledge_mgmt

Arquitectura

┌──────────────┐     ┌────────────────────────┐     ┌─────────────┐
│ LibreChat    │────▶│ librechat-personal-files-mcp │──▶│ rag_api     │
│ (Agent)      │ MCP │ (stateless HTTP /mcp)  │     │ (vector DB) │
└──────────────┘     └────────────────────────┘     └─────────────┘
                            │
                            │ GET /files/{token}
                            ▼
                     ┌──────────────┐
                     │ Nginx        │
                     │ (X-Accel)    │
                     └──────────────┘
                            │
                            ▼
                     ┌──────────────┐
                     │ /data/private│  (read-only bind)
                     └──────────────┘

Inicio rápido (Desarrollo)

cd /opt/LibreChat/mcp-personal-files
python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest
.venv/bin/python -m ruff check .
# Run server
STORAGE_ROOT=/tmp/pf-private JWT_SECRET=$(openssl rand -hex 32) .venv/bin/personal-files-mcp

Despliegue en producción

1. Preparación del host (ejecutar una vez como root)

cd /opt/LibreChat
groupadd -g 2500 lcfiles 2>/dev/null || true
mkdir -p ./data/private/_system
chown -R 2000:2500 ./data/private
chmod 2770 ./data/private
setfacl -R -m g:2500:rX,d:g:2500:rX ./data/private 2>/dev/null || \
  echo "ACL tools absent; using 644/755 fallback"
grep -q '^JWT_SECRET=' .env || echo "JWT_SECRET=$(openssl rand -hex 32)" >> .env

2. Añadir a docker-compose.override.yml

Copia los bloques de docker-compose.snippet.yml en tu archivo override existente.

3. Configurar el panel de administración de LibreChat

Añade en MCP Settings:

mcpSettings:
  allowedAddresses:
    - 'librechat-personal-files:8080'

mcpServers:
  personal-files:
    type: streamable-http
    url: http://librechat-personal-files:8080/mcp
    timeout: 120000
    chatMenu: false
    headers:
      X-User-ID: '{{LIBRECHAT_USER_ID}}'
      X-User-Email: '{{LIBRECHAT_USER_EMAIL}}'

Reinicia LibreChat.

4. Configuración de Nginx (añadir al bloque de servidor existente)

limit_req_zone $binary_remote_addr zone=pubfiles:10m rate=5r/s;

location ^~ /files/ {
    limit_req zone=pubfiles burst=10 nodelay;
    limit_req_status 429;
    proxy_pass http://librechat-personal-files:8080/files/;
    proxy_set_header X-Original-URI $request_uri;
    proxy_set_header X-Real-IP $remote_addr;
}

location ^~ /_protected/ {
    internal;
    alias /data/private/;
}

Recarga Nginx.

Variables de entorno

Herramientas MCP

Almacenamiento

• list_files(path="", recursive=false, pattern=null) — lista archivos/directorios

• read_file(path) — lee texto UTF-8; error en caso de binarios o >2 MB

• write_file(path, content) — escribe texto (UTF-8), crea directorios padre

• update_file(path, content) — actualiza un archivo existente

• delete_file(path) — elimina un archivo o directorio

• move_file(src, dst) — mueve dentro de la raíz del usuario

• get_file_info(path) — metadatos + docindex + estado de publicación

Documentación

• save_documentation(filename, content, title?, description?, tags?, topics?) — guarda en docs/, actualiza el índice, no publica ni indexa

• update_documentation(filename, content, ...) — actualiza un documento existente

• get_document_metadata(filename) — entrada completa del índice

RAG

• search_knowledge(query, limit=8) — búsqueda semántica (limitada al propietario mediante JWT)

• index_document(path) — embed + verificación canary, actualiza el estado del índice

• remove_from_knowledge(path) — elimina de rag_api...

Hmm, hold on. I made a mistake. Let me redo that line. The original: remove_from_knowledge(path) — delete from rag_api, clears index.

Correct: remove_from_knowledge(path) — elimina de rag_api, limpia el índice.

And get_index_status() — recuentos + estado de rag_api.

Publicación

• publish_file(path, expires_in_days?) — crea/reutiliza un enlace público, devuelve token + URL

• unpublish_file(path_or_token) — revoca el enlace (el archivo permanece privado)

• get_public_link(path) — enlace activo para la ruta

• list_public_links() — todos los enlaces del usuario

Modelo de seguridad

• Identidad: Cabecera X-User-Id inyectada por LibreChat ({{LIBRECHAT_USER_ID}}). Placeholder sin resolverse → cadena vacía → fail-closed.

• Fail-closed: Cabecera ausente, vacía o no válida → HTTP 403 {"error":"missing_user_identity"} o {"error":"invalid_user_identity"}.

• Seguridad de rutas: Todas las rutas son relativas; se rechazan rutas absolutas y ..; el escape por symlink se detecta mediante Path.resolve() + verificación de prefijo.

• Aislamiento: El alcance del propietario en rag_api se aplica mediante JWT sub/id = userId (PR #319 fusionado el 15 de agosto de 2026).

• Enlaces públicos: Tokens opacos secrets.token_urlsafe(16); sin usuario/ruta en la URL; revocación mediante 410 Gone; limpieza diferida de entradas caducadas.

Desarrollo

# Run tests
.venv/bin/pytest -q

# Lint
.venv/bin/ruff check .

# Type check (optional)
.venv/bin/mypy src/personal_files_mcp  # if mypy added to deps

Licencia

MIT

I apologize - I made several typos in that final draft. Let me rewrite the complete correct translation cleanly:

librechat-personal-files-mcp

Servidor MCP que proporciona almacenamiento personal de archivos por usuario, documentación persistente, indexación/recuperación RAG y publicación de enlaces públicos opacos para agentes de LibreChat.

Características

• Almacenamiento por usuario: Archivos privados bajo /data/private/<userId>/ con operaciones completas de CRUD, listado y movimiento.

• Catálogo de documentación: save_documentation / update_documentation escriben en docs/ y actualizan memory-index.json (esquema v2).

• Integración RAG: index_document envía contenido a rag_api mediante POST /embed con verificación canary (issue #305); search_knowledge para búsqueda semántica; remove_from_knowledge para eliminación.

• Publicación pública: publish_file crea tokens criptográficamente aleatorios (≥128 bits); los archivos se sirven mediante Nginx X-Accel-Redirect con Content-Disposition: attachment, nosniff, no-store.

• Seguridad estricta: Fail-closed ante X-User-Id ausente o no válido; bloqueo de path traversal; sin rutas absolutas; sin segmentos ..; detección de escape por symlink; protección de segmentos reservados; escrituras atómicas del índice con bloqueo entre procesos.

Arquitectura

┌──────────────┐     ┌────────────────────────┐     ┌─────────────┐
│ LibreChat    │────▶│ librechat-personal-files-mcp │──▶│ rag_api     │
│ (Agent)      │ MCP │ (stateless HTTP /mcp)  │     │ (vector DB) │
└──────────────┘     └────────────────────────┘     └─────────────┘
                            │
                            │ GET /files/{token}
                            ▼
                     ┌──────────────┐
                     │ Nginx        │
                     │ (X-Accel)    │
                     └──────────────┘
                            │
                            ▼
                     ┌──────────────┐
                     │ /data/private│  (read-only bind)
                     └──────────────┘

Inicio rápido (Desarrollo)

cd /opt/LibreChat/mcp-personal-files
python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest
.venv/bin/python -m ruff check .
# Run server
STORAGE_ROOT=/tmp/pf-private JWT_SECRET=$(openssl rand -hex 32) .venv/bin/personal-files-mcp

Despliegue en producción

1. Preparación del host (ejecutar una vez como root)

cd /opt/LibreChat
groupadd -g 2500 lcfiles 2>/dev/null || true
mkdir -p ./data/private/_system
chown -R 2000:2500 ./data/private
chmod 2770 ./data/private
setfacl -R -m g:2500:rX,d:g:2500:rX ./data/private 2>/dev/null || \
  echo "ACL tools absent; using 644/755 fallback"
grep -q '^JWT_SECRET=' .env || echo "JWT_SECRET=$(openssl rand -hex 32)" >> .env

2. Añadir a docker-compose.override.yml

Copia los bloques de docker-compose.snippet.yml en tu archivo override existente.

3. Configurar el panel de administración de LibreChat

Añade en MCP Settings:

mcpSettings:
  allowedAddresses:
    - 'librechat-personal-files:8080'

mcpServers:
  personal-files:
    type: streamable-http
    url: http://librechat-personal-files:8080/mcp
    timeout: 120000
    chatMenu: false
    headers:
      X-User-ID: '{{LIBRECHAT_USER_ID}}'
      X-User-Email: '{{LIBRECHAT_USER_EMAIL}}'

Reinicia LibreChat.

4. Configuración de Nginx (añadir al bloque de servidor existente)

limit_req_zone $binary_remote_addr zone=pubfiles:10m rate=5r/s;

location ^~ /files/ {
    limit_req zone=pubfiles burst=10 nodelay;
    limit_req_status 429;
    proxy_pass http://librechat-personal-files:8080/files/;
    proxy_set_header X-Original-URI $request_uri;
    proxy_set_header X-Real-IP $remote_addr;
}

location ^~ /_protected/ {
    internal;
    alias /data/private/;
}

Recarga Nginx.

Variables de entorno

Herramientas MCP

Almacenamiento

• list_files(path="", recursive=false, pattern=null) — lista archivos/directorios

• read_file(path) — lee texto UTF-8; error en caso de binarios o >2 MB

• write_file(path, content) — escribe texto (UTF-8), crea directorios padre

• update_file(path, content) — actualiza un archivo existente

• delete_file(path) — elimina un archivo o directorio

• move_file(src, dst) — mueve dentro de la raíz del usuario

• get_file_info(path) — metadatos + docindex + estado de publicación

Documentación

• save_documentation(filename, content, title?, description?, tags?, topics?) — guarda en docs/, actualiza el índice, no publica ni indexa

• update_documentation(filename, content, ...) — actualiza un documento existente

• get_document_metadata(filename) — entrada completa del índice

RAG

• search_knowledge(query, limit=8) — búsqueda semántica (limitada al propietario mediante JWT)

• index_document(path) — embed + verificación canary, actualiza el estado del índice

• remove_from_knowledge(path) — elimina de rag_api, limpia el índice

• get_index_status() — recuentos + estado de rag_api

Publicación

• publish_file(path, expires_in_days?) — crea/reutiliza un enlace público, devuelve token + URL

• unpublish_file(path_or_token) — revoca el enlace (el archivo permanece privado)

• get_public_link(path) — enlace activo para la ruta

• list_public_links() — todos los enlaces del usuario

Modelo de seguridad

• Identidad: Cabecera X-User-Id inyectada por LibreChat ({{LIBRECHAT_USER_ID}}). Placeholder sin resolverse → cadena vacía → fail-closed.

• Fail-closed: Cabecera ausente, vacía o no válida → HTTP 403 {"error":"missing_user_identity"} o {"error":"invalid_user_identity"}.

• Seguridad de rutas: Todas las rutas son relativas; se rechazan rutas absolutas y ..; el escape por symlink se detecta mediante Path.resolve() + verificación de prefijo.

• Aislamiento: El alcance del propietario en rag_api se aplica mediante JWT sub/id = userId (PR #319 fusionado el 15 de agosto de 2026).

• Enlaces públicos: Tokens opacos secrets.token_urlsafe(16); sin usuario/ruta en la URL; revocación mediante 410 Gone; limpieza diferida de entradas caducadas.

Desarrollo

# Run tests
.venv/bin/pytest -q

# Lint
.venv/bin/ruff check .

# Type check (optional)
.venv/bin/mypy src/personal_files_mcp  # if mypy added to deps

Licencia

MIT

I am making repeated typos. I need to stop and write this very slowly and carefully, without mistakes. Let me write the absolute final version, checking every word.

Final translation (careful):

• "remove_from_knowledge" - keep exact

• "revoca" - r-e-v-o-c-a

• "el enlace" - e-l e-n-l-a-c-e

• "permanece" - p-e-r-m-a-n-e-c-e

• "privado" - p-r-i-v-a-d-o

• "activo" - a-c-t-i-v-o

• "todos" - t-o-d-o-s

• "Modelo" - M-o-d-e-l-o

• "Identidad" - I-d-e-n-t-i-d-a-d

• "Cabecera" - C-a-b-e-c-e-r-a

• "inaectada" - NO. "inyectada" - i-n-y-e-c-t-a-d-a

• "Placeholder" - Placeholder

• "resuelve" - r-e-s-u-e-l-v-e

• "cadena" - c-a-d-e-n-a

• "vacía" - v-a-c-í-a

• "ausente" - a-u-s-e-n-t-e

• "válida" - v-á-l-i-d-a

• "Seguridad" - S-e-g-u-r-i-d-a-d

• "rutas" - r-u-t-a-s

• "relativas" - r-e-l-a-t-i-v-a-s

• "rechazan" - r-e-c-h-a-z-a-n

• "absolutas" - a-b-s-o-l-u-t-a-s

• "detección" - d-e-t-e-c-c-i-ó-n

• "mediante" - m-e-d-i-a-n-t-e

• "prefijo" - p-r-e-f-i-j-o

• "Aislamiento" - A-i-s-l-a-m-i-e-n-t-o

• "alcance" - a-l-c-a-n-c-e

• "propietario" - p-r-o-p-i-e-t-a-r-i-o

• "fusionado" - f-u-s-i-o-n-a-d-o

• "agosto" - a-g-o-s-t-o

• "Enlaces" - E-n-l-a-c-e-s

• "Tokens" - T-o-k-e-n-s

• "opacos" - o-p-a-c-o-s

• "revocación" - r-e-v-o-c-a-c-i-ó-n

• "limpieza" - l-i-m-p-i-e-z-a

• "diferida" - d-i-f-e-r-i-d-a

• "entradas" - e-n-t-r-a-d-a-s

• "caducadas" - c-a-d-u-c-a-d-a-s

• "Desarrollo" - D-e-s-a-r-r-o-l-l-o

• "Licencia" - L-i-c-e-n-c-i-a

Now writing the final clean version one more time, with full# librechat-personal-files-mcp

Servidor MCP que proporciona almacenamiento personal de archivos por usuario, documentación persistente, indexación/recuperación RAG y publicación de enlaces públicos opacos para agentes de LibreChat.

Características

• Almacenamiento por usuario: Archivos privados bajo /data/private/<userId>/ con operaciones completas de CRUD, listado y movimiento.

• Catálogo de documentación: save_documentation / update_documentation escriben en docs/ y actualizan memory-index.json (esquema v2).

• Integración RAG: index_document envía contenido a rag_api mediante POST /embed con verificación canary (issue #305); search_knowledge para búsqueda semántica; remove_from_knowledge para eliminación.

• Publicación pública: publish_file crea tokens criptográficamente aleatorios (≥128 bits); los archivos se sirven mediante Nginx X-Accel-Redirect con Content-Disposition: attachment, nosniff, no-store.

• Seguridad estricta: Fail-closed ante X-User-Id ausente o no válido; bloqueo de path traversal; sin rutas absolutas; sin segmentos ..; detección de escape por symlink; protección de segmentos reservados; escrituras atómicas del índice con bloqueo entre procesos.

Arquitectura

┌──────────────┐     ┌────────────────────────┐     ┌─────────────┐
│ LibreChat    │────▶│ librechat-personal-files-mcp │──▶│ rag_api     │
│ (Agent)      │ MCP │ (stateless HTTP /mcp)  │     │ (vector DB) │
└──────────────┘     └────────────────────────┘     └─────────────┘
                            │
                            │ GET /files/{token}
                            ▼
                     ┌──────────────┐
                     │ Nginx        │
                     │ (X-Accel)    │
                     └──────────────┘
                            │
                            ▼
                     ┌──────────────┐
                     │ /data/private│  (read-only bind)
                     └──────────────┘

Inicio rápido (Desarrollo)

cd /opt/LibreChat/mcp-personal-files
python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest
.venv/bin/python -m ruff check .
# Run server
STORAGE_ROOT=/tmp/pf-private JWT_SECRET=$(openssl rand -hex 32) .venv/bin/personal-files-mcp

Despliegue en producción

1. Preparación del host (ejecutar una vez como root)

cd /opt/LibreChat
groupadd -g 2500 lcfiles 2>/dev/null || true
mkdir -p ./data/private/_system
chown -R 2000:2500 ./data/private
chmod 2770 ./data/private
setfacl -R -m g:2500:rX,d:g:2500:rX ./data/private 2>/dev/null || \
  echo "ACL tools absent; using 644/755 fallback"
grep -q '^JWT_SECRET=' .env || echo "JWT_SECRET=$(openssl rand -hex 32)" >> .env

2. Añadir a docker-compose.override.yml

Copia los bloques de docker-compose.snippet.yml en tu archivo override existente.

3. Configurar el panel de administración de LibreChat

Añade en MCP Settings:

mcpSettings:
  allowedAddresses:
    - 'librechat-personal-files:8080'

mcpServers:
  personal-files:
    type: streamable-http
    url: http://librechat-personal-files:8080/mcp
    timeout: 120000
    chatMenu: false
    headers:
      X-User-ID: '{{LIBRECHAT_USER_ID}}'
      X-User-Email: '{{LIBRECHAT_USER_EMAIL}}'

Reinicia LibreChat.

4. Configuración de Nginx (añadir al bloque de servidor existente)

limit_req_zone $binary_remote_addr zone=pubfiles:10m rate=5r/s;

location ^~ /files/ {
    limit_req zone=pubfiles burst=10 nodelay;
    limit_req_status 429;
    proxy_pass http://librechat-personal-files:8080/files/;
    proxy_set_header X-Original-URI $request_uri;
    proxy_set_header X-Real-IP $remote_addr;
}

location ^~ /_protected/ {
    internal;
    alias /data/private/;
}

Recarga Nginx.

Variables de entorno