使用说明
本地文件MCP服务器
一种模型上下文协议（MCP）服务器，提供从指定目录对本地文件的安全访问。
特性
- 列出已配置目录中的文件
- 读取文件内容（文本和二进制）
- 文件大小和扩展名过滤
- 安全路径验证
- 通过.env文件或环境变量进行配置
配置
方法1:.env文件（推荐）
创建一个 .env 文件与位于同一目录中 app.py:
# Comma-separated list of allowed directories
ALLOWED_DIRECTORIES=/home/user/documents,/home/user/projects,/path/to/your/files
# Maximum file size in bytes (default: 10MB)
MAX_FILE_SIZE=10485760
# Allowed file extensions (comma-separated)
ALLOWED_EXTENSIONS=.txt,.md,.py,.js,.json,.yaml,.yml,.csv,.xml,.html,.css
方法2：环境变量
直接设置环境变量：
export ALLOWED_DIRECTORIES="/home/user/documents,/home/user/projects"
export MAX_FILE_SIZE=10485760
export ALLOWED_EXTENSIONS=".txt,.md,.py,.js,.json,.yaml,.yml,.csv,.xml,.html,.css"
用法
启动服务器
python app.py
可用工具
- lf_list_files -列出允许目录中的文件
- lf_read_file -读取特定文件的内容
- lf_get_config -获取当前服务器配置
安全
- 仅限于已配置的文件
ALLOWED_DIRECTORIES可以访问 - 文件大小限制可防止读取过大的文件
- 文件扩展名筛选限制对指定文件类型的访问
- 所有路径都经过解析和验证，以防止目录遍历攻击
故障排除
“未配置允许的目录”错误
以下情况下会发生此错误：
- 不存在.env文件 -创建一个
.env提交ALLOWED_DIRECTORIES设置 - 空允许_目录 -确保该值不为空
- 工作目录错误 -服务器正在查找
.env首先在脚本目录中，然后在当前目录中 - 未设置环境变量 -如果不使用.env，请确保环境变量设置正确
调试配置
使用 lf_get_config 用于检查服务器实际使用的配置的工具：
# This will show the current configuration
lf_get_config()
示例.env文件
# Example configuration for a development environment
ALLOWED_DIRECTORIES=/home/alice/projects,/home/alice/documents,/tmp/safe-files
MAX_FILE_SIZE=52428800
ALLOWED_EXTENSIONS=.txt,.md,.py,.js,.json,.yaml,.yml,.csv,.xml,.html,.css,.log
需求
- Python 3.7+
- fastmcp库
- pathlib（内置）
安装
pip install fastmcp
