MCP Smb Server

What is Mcp Smb Server?

Mcp Smb Server is a runtime file-access gateway for AI agents using the Model Context Protocol (MCP). It allows agents to access SMB/CIFS shares or local filesystem paths while preserving native filesystem permission enforcement—if the underlying system cannot read a file, the agent cannot read it either.

How to use Mcp Smb Server?

Build the server from source with Go 1.24+, then run it in SMB mode via environment variables (e.g., MCP_MODE=smb, SMB_ADDR, SMB_SHARE) or in local mode with a config file (e.g., ./mcp-smb-server --config config.yaml). Configuration is process-level and loaded once at startup.

Key features of Mcp Smb Server

• Exposes files only at access time (no indexing)
• Relies on native SMB/OS permission enforcement
• Supports SMB/CIFS and local filesystem backends
• Communicates over stdio (VS Code/agent friendly)
• Provides list_directory and read_file MCP tools

Use cases of Mcp Smb Server

• Let AI agents browse and read files from SMB shares without duplicating data
• Give agents controlled local filesystem access with OS permission enforcement
• Integrate file access into MCP-aware environments (e.g., VS Code, custom agents)
• Enable runtime file access without indexing, sync, or embedding pipelines