kuik-fileshare-mcp
Enables KUIK Agent to access on-premise SMB/CIFS shares on a Windows Server using the employee's own credentials, enforcing live ACLs. Supports file operations such as list, read, write, search, move, copy, delete, and upload/download without mounting or duplicating data.
README
kuik-fileshare-mcp
Servidor MCP que da a un agente de KUIK Agent acceso a una carpeta compartida on-premise (SMB/CIFS) de un Windows Server, autenticándose con las credenciales del propio empleado — de modo que el fileserver aplica en vivo las ACLs que correspondan a ese usuario.
No monta nada ni duplica datos: habla SMB en espacio de usuario con rclone (backend smb),
por lo que no requiere mount, FUSE ni capabilities extra en el contenedor.
Herramientas
| Tool | Descripción |
|---|---|
list_files |
Lista archivos y carpetas de un directorio del share |
list_shares |
Lista los shares que el administrador ha configurado |
stat_item |
Metadatos (tipo, tamaño, fecha) o existencia de un ítem |
read_file |
Lee un archivo de texto (los ofimáticos → download_file + portal_read_document) |
search_files |
Busca por nombre (subcadena) bajo una ruta |
write_file |
Crea/sobrescribe un archivo de texto |
make_dir |
Crea una carpeta (y sus padres) |
move_item |
Mueve/renombra dentro o entre shares |
copy_item |
Copia dentro o entre shares |
delete_item |
Borra un archivo; carpeta no vacía requiere recursive=true |
download_file |
Trae un archivo del share al espacio local del agente (~/temp, ~/files) |
upload_file |
Sube un archivo local al share |
Todas las operaciones están acotadas por los permisos del empleado en el fileserver.
Variables de entorno
Las inyecta server/lib/fileshare-service.js de KUIK Agent en getMcpEntry:
| Variable | Obligatoria | Descripción |
|---|---|---|
FILESHARE_HOST |
sí | Host o IP del fileserver |
FILESHARE_USER |
sí | Usuario de Windows/AD del empleado |
FILESHARE_PASS |
sí | Contraseña (en claro; se "obscurece" en memoria, nunca se escribe en disco) |
FILESHARE_DOMAIN |
no | Dominio AD (NetBIOS), si aplica |
FILESHARE_PORT |
no | Puerto SMB (default 445) |
FILESHARE_SHARES |
no | Lista CSV de shares autorizados; si se define, restringe el acceso a esos |
FILESHARE_TIMEOUT_MS |
no | Timeout por operación rclone (default 60000) |
FILESHARE_MAX_READ_BYTES |
no | Límite de read_file como texto (default 1048576) |
RCLONE_BIN |
no | Ruta a rclone (default rclone, ya presente en la imagen) |
HOME |
sí | Home del empleado; acota las rutas locales de download/upload |
Desarrollo
npm install
npm run build
# requiere rclone en el PATH y un servidor SMB de prueba
FILESHARE_HOST=127.0.0.1 FILESHARE_USER=ana FILESHARE_PASS=secret \
FILESHARE_SHARES=Comun,Direccion HOME=/tmp/agent node dist/index.js
Seguridad
- La contraseña llega en claro por env y se transforma con
rclone obscureen memoria; nunca se persiste en disco en claro. download_file/upload_filesolo pueden tocar rutas dentro deHOME.- Las rutas con
..se rechazan; los separadores Windows (\) se normalizan. - El borrado recursivo exige
recursive=trueexplícito.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.