Back to Home
nasuni-labs icon

nasuni-mcp-desktop

Verified Safe

by nasuni-labs

Overview

Provides an AI agent (like Claude Desktop) with controlled, local access to files on mounted Nasuni SMB shares for experimental data analysis.

Installation

Run Command
FILE_SYSTEM_PATH="/path/to/mounted/share" uv run --quiet --directory MCP_SERVER_PATH server.py

Environment Variables

  • FILE_SYSTEM_PATH
  • LOG_DESTINATION
  • MAX_SCAN_ITEMS
  • MAX_RETURN_FILE_SIZE
  • MAX_READ_FILE_SIZE
  • EXCLUDE_FOLDERS
  • LOG_LEVEL
  • IGNORE_FILES_EXP
  • IGNORE_FOLDERS_EXP
  • ERROR_TRACEBACK

Security Notes

The server implements robust path traversal protection using `os.path.abspath` and `os.path.commonpath` to ensure file access is confined to the specified base directory. It enforces file size limits (`MAX_READ_FILE_SIZE`, `MAX_RETURN_FILE_SIZE`) and folder exclusions (`exclude_folders`) to mitigate resource exhaustion and unauthorized access to sensitive areas. However, processing arbitrary file contents (PDF, DOCX, images) using third-party libraries (`pypdf`, `python-docx`, `Pillow`, `hachoir`) inherently introduces a potential attack surface through malformed or malicious files, though the code does not appear to directly execute or mishandle extracted content. No direct `eval` or `exec` commands were found. A separate `process_traffic.py` script for repository analytics uses `GH_TOKEN` from environment variables, which is good practice for credentials. The project explicitly states it's for 'experimentation only - not intended for production use'.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassHigh
Avg Tokens150000
Stars0
Forks2
Last Update2026-01-19

Tags

File System AccessSMBAI ExperimentationData RetrievalMCP Server