MCP文件系统服务器

MCP文件系统服务器

一个为AI助手提供安全文件操作的MCP协议服务器,支持读写和列出指定目录中的文件。

快速入门

安装

  1. 克隆仓库:git clone https://github.com/MarcusJellinghaus/mcp_server_filesystem.git
  2. 进入项目目录:cd mcp-server-filesystem
  3. 创建虚拟环境:python -m venv venv
  4. 激活虚拟环境(Windows: venv\Scripts\activate,macOS/Linux: source venv/bin/activate
  5. 安装依赖:pip install -e .

启动服务

运行以下命令启动服务器:

python -m src.main --project-dir /path/to/project

可选参数:--log-level LEVEL 设置日志级别,--log-file PATH 保存结构化日志。

使用 VSCode/Cline 集成

  1. 编辑配置文件 %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  2. 添加如下配置并替换路径:
{
  "mcpServers": {
    "filesystem": {
      "command": "C:\\path\\to\\mcp_server_filesystem\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\mcp_server_filesystem\\src\\main.py",
        "--project-dir",
        "C:\\Users\\YourUsername\\Documents\\Projects\\MyProject"
      ],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\mcp_server_filesystem\\"
      }
    }
  }
}
  1. 重启 VSCode。

更多详情请参考 README