MCP Filesystem Server

Name: MCP Filesystem Server
Author: philgei

@philgei

代码仓库

关于 MCP Filesystem Server

暂无概览

基本信息

分类

文件与存储

许可证

MIT

运行时

python

传输方式

stdio

发布者

philgei

配置

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

{
  "mcpServers": {
    "mcp-server-filesystem-philgei": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

工具

未检测到工具

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

概览

What is MCP Filesystem Server?

MCP Filesystem Server is an unofficial Python-based proof of concept (POC) that enables Claude Desktop to access and interact with local filesystem directories via the Model Context Protocol (MCP). It is not affiliated with Anthropic and should not be used in production environments; it serves educational and exploratory purposes only.

How to use MCP Filesystem Server?

Install the server using UVX in a virtual environment, then configure it in the claude_desktop_config.json file by specifying the server command “mcp-server-filesystem” and the allowed directories as arguments. After restarting Claude Desktop, click the paperclip icon and select the MCP menu to see the server in the integrations list.

Key features of MCP Filesystem Server

Allows Claude Desktop to read and write files in configured directories.
Restricts access only to directories listed in the configuration arguments.
Supports multiple directories specified as command arguments.
Enforces strict path validation to prevent access outside allowed directories.
Simple installation via UVX and configuration via claude_desktop_config.json.

Use cases of MCP Filesystem Server

Demonstrating MCP server functionality for educational or prototyping purposes.
Experimenting with local file access from Claude Desktop in a sandboxed environment.
Testing path validation and security constraints in a non‑production setting.

FAQ from MCP Filesystem Server

Is MCP Filesystem Server affiliated with Anthropic?

No, this is an unofficial port created solely as a Proof of Concept and is not affiliated with Anthropic. It should not be used in production.

Which directories can the server access?

Only the directories explicitly listed in the args array of your claude_desktop_config.json will be accessible. The server enforces strict path validation to prevent access outside those directories.

What are the installation requirements?

You need Python with UVX installed, and the server runs inside a virtual environment. The package is installed via uv pip install -e . after creating and activating the environment.

How do I verify the server is installed correctly?

Run uv pip list to confirm the package is present and ensure your Python environment is activated. If the command is not found, check the environment activation.

What should I do if the server does not appear in Claude Desktop?

Check the syntax of your claude_desktop_config.json file and ensure it is valid JSON. Then restart Claude Desktop to apply the changes. Also verify that the specified directories exist and you have read permissions for them.

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

File Context Server

bsmi021

A Model Context Protocol (MCP) server that provides file system context to Large Language Models (LLMs). This server enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.