MCP Filesystem Python

local-only server

The server can only run on the client’s local machine because it depends on local resources.

MCP 文件系统 Python

模型上下文协议 (MCP) 服务器提供对指定目录中的文件的安全、只读访问。

特征

  • 使用 `file://` URI 方案将文件公开为 MCP 资源
  • 通过 MCP 工具提供文件搜索功能
  • 尊重 .gitignore 模式
  • 安全功能包括路径遍历保护
  • MIME类型检测

安装

使用紫外线:

uv add mcp-filesystem-python

用法

运行服务器:

uv run src/filesystem/server.py /path/to/directory

Claude 桌面集成

配置示例

可以在“examples”目录中找到 Claude Desktop 的示例配置:

  • `examples/claude_desktop_config.json`:macOS/Linux 示例
  • `examples/claude_desktop_config_windows.json`:Windows 示例

这些文件应放置在:

  • macOS:`~/Library/Application Support/Claude/claude_desktop_config.json`
  • Windows:`%AppData%\Claude\claude_desktop_config.json`

请确保:

  1. 用您的实际路径替换路径
  2. 对于 macOS/Linux,使用正斜杠 (`/`);对于 Windows,使用反斜杠 (`\\`)
  3. 使用绝对路径(而不是相对路径)

发展

  1. 克隆存储库
  2. 创建虚拟环境和同步要求, uv sync

执照

麻省理工学院

-
security - not tested
A
license - permissive license
-
quality - not tested

安全的 MCP 服务器,可在指定目录内实现只读访问和文件搜索功能,同时遵守 .gitignore 模式。

  1. Features
    1. Installation
      1. Usage
        1. Claude Desktop Integration
          1. Configuration Examples
        2. Development
          1. License
            ID: admt9a4f34