Directory Browser MCP Server

一个用于浏览目录和文件的MCP (Model Context Protocol) 服务器。

功能特性

📁 目录浏览 - 列出指定目录的内容
📄 文件信息 - 获取文件/目录的详细信息
🔍 权限检查 - 检查路径的访问权限
🛡️ 安全控制 - 基于白名单的目录访问控制

安装

cd directory_browser_mcp
pip install -e .

配置

编辑 config.json 文件来配置允许访问的目录：

{
  "allowed_directories": [
    "/Users/用户名/Documents",
    "/Users/用户名/Desktop",
    "/项目根目录"
  ],
  "show_hidden_files": false,
  "max_entries": 1000
}

使用方法

作为MCP服务器运行

python -m directory_browser_mcp

可用工具

list_directory - 列出目录内容
- path: 目录路径
- show_hidden: 是否显示隐藏文件 (可选)
get_file_info - 获取文件详细信息
- path: 文件或目录路径
check_path_access - 检查路径访问权限
- path: 要检查的路径

安全特性

✅ 白名单目录访问控制
✅ 路径穿越攻击防护
✅ 文件系统权限检查
✅ 安全错误处理

示例

# 列出目录
{
  "tool": "list_directory",
  "arguments": {
    "path": "/Users/username/Documents",
    "show_hidden": false
  }
}

# 获取文件信息
{
  "tool": "get_file_info",
  "arguments": {
    "path": "/Users/username/Documents/file.txt"
  }
}

# 检查访问权限
{
  "tool": "check_path_access",
  "arguments": {
    "path": "/Users/username/Documents"
  }
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

directory_browser_mcp-0.1.5.tar.gz (11.9 kB view details)

Uploaded Oct 11, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

directory_browser_mcp-0.1.5-py3-none-any.whl (12.5 kB view details)

Uploaded Oct 11, 2025 Python 3

File details

Details for the file directory_browser_mcp-0.1.5.tar.gz.

File metadata

Download URL: directory_browser_mcp-0.1.5.tar.gz
Upload date: Oct 11, 2025
Size: 11.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for directory_browser_mcp-0.1.5.tar.gz
Algorithm	Hash digest
SHA256	`921bc7e6201b4b98418a16c315216ea7e3ab35f5b6e6e0a75e1eeb945f20200d`
MD5	`fa6efcb8a4b7377261ad7ee474d71a12`
BLAKE2b-256	`e933936618203533a701f97c884366033f2aa571200c7a575657d6c1c9fa1220`

See more details on using hashes here.

File details

Details for the file directory_browser_mcp-0.1.5-py3-none-any.whl.

File metadata

Download URL: directory_browser_mcp-0.1.5-py3-none-any.whl
Upload date: Oct 11, 2025
Size: 12.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for directory_browser_mcp-0.1.5-py3-none-any.whl
Algorithm	Hash digest
SHA256	`109a48f250837711a648c94b6721ce5dccaae69bde44bc868d34da426e559580`
MD5	`3d6599a16ed84c281e561a42d0392b2b`
BLAKE2b-256	`2c3d38108847add267ab5fa41a48002575388640cd155ca23a8d0cdf823fb1e2`