File system MCP Server

@iBz-04

代码仓库

基本信息

分类

文件与存储

传输方式

stdio

作者

iBz-04

关于 File system MCP Server

This is a File system mcp server that could allow an LLM to read and list files from a specified safe directory on your local machine.

#python #open-source #filesystem #mcp #ai-agents #llm #claude-ai #llm-agent #claude-api #model-context-protocol #mcp-server #model-context-protocol-servers #mcp-sdk #python-mcp#claudemcp

File system MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "Filesys": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

File system MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

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

概览

What is File system MCP?

File system MCP is a lightweight MCP server built with Python and the mcp library that securely exposes file contents and metadata from a preconfigured directory. It provides endpoints to list files and read file details, and includes an optional integration with Anthropic's Claude AI for natural language interaction.

How to use File system MCP?

Clone the repository, optionally create a virtual environment, install dependencies from requirements.txt, set the Anthropic API key in .env.local, and configure the target directory in config/config.json. Start the server with python run.py, then in a separate terminal run python interact_with_claude.py to chat with Claude, or directly request files://list or files://read/{filename} via any MCP-compatible client.

Key features of File system MCP

List all files in a configurable directory.
Read file contents and metadata (size, last modified).
Integrates with Anthropic Claude for natural language queries.
Validates paths to prevent directory traversal attacks.
Configurable base directory via config/config.json.
Built with Python and FastMCP for lightweight operation.

Use cases of File system MCP

Securely expose a local folder to AI assistants like Claude.
Allow natural language file queries without direct shell access.
Programmatic file listing and reading over the MCP protocol.
Rapid file inspection during development or testing.
Demonstrate MCP server-client interaction with a real file system.

常见问题

What dependencies does File system MCP require?

Python, the `mcp` library, and optionally the Anthropic SDK for Claude integration (see `requirements.txt`). For Claude usage, an Anthropic API key must be stored in `.env.local`.

Where do the files live?

The server reads from the directory specified in `config/config.json`; the default is `./safe_folder`. Only files within that configured directory are accessible.

How does File system MCP ensure security?

The server validates all file paths and rejects any request that attempts directory traversal, restricting access solely to the configured directory.

What transport does File system MCP use?

It uses the MCP protocol over standard I/O, exposing two resource endpoints: `files://list` and `files://read/{filename}`.

Can I use File system MCP without Claude?

Yes. The MCP server runs independently; you can interact with it via any MCP-compatible client by requesting the built-in file endpoints directly.

文件与存储分类下的更多 MCP 服务器

S3 MCP Server

samuraikun

MCP server to integrate AWS S3 and LLM

DeviceLink

Jayanka Sampath

DeviceLink lets you share folders from your computer with AI assistants, securely and in real-time. Nothing is uploaded. Your files stay on your machine, and are only accessible while the device sharing them is connected

box-mcp-server

hmk

A Box model context protocol server to search, read and access files

Filesystem

modelcontextprotocol

Model Context Protocol Servers

88.1K

MCP File System Server

MarcusJellinghaus

MCP Workspace Server: A secure Model Context Protocol server providing file, git, and GitHub tools for AI assistants within a sandboxed project directory.