Mcp Smb Server

Name: Mcp Smb Server
Author: natan04

@natan04

代码仓库

关于 Mcp Smb Server

暂无概览

基本信息

分类

其他

传输方式

stdio

发布者

natan04

提交者

Natan Elul

配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块，请前往代码仓库查看安装说明。

代码仓库

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from Mcp Smb Server

How does Mcp Smb Server differ from file indexing solutions?

It does not sync, index, embed, or copy files. All access happens at runtime, relying on native filesystem or SMB permissions—no permission bypass or policy reimplementation.

What are the runtime requirements?

Go 1.24 or later. For SMB mode, access to an SMB/CIFS server. For local mode, appropriate filesystem permissions.

Where does file data reside?

Data stays on the original filesystem or SMB share. The server never stores or duplicates it.

What MCP tools does it provide?

list_directory (lists files at a path) and read_file (reads a bounded portion, default 8 KB).

What transports and authentication does it use?

Communication over stdio only. SMB authentication is handled by the SMB server (credentials set via environment variables, not stored in config files).