MCP 服务器

MCP File Server

一个安全的文件系统操作模型上下文协议（MCP）服务器。它使像 Claude 和 Cursor 这样的 AI 助手能够访问、读取、写入和管理你系统上的文件，并具有强大的路径验证和动态存储位置管理功能。

Priyonuj

开发者工具

访问服务器

README

MCP 文件服务器

一个使用模型上下文协议 (MCP) 的安全文件服务器实现，为文件系统操作提供标准化接口。

概述

MCP 文件服务器是一个 Node.js 应用程序，它实现了一个专门用于文件操作的 MCP 服务器。它提供了一种安全且标准化的方式，通过 MCP 协议与文件系统进行交互，适用于与 Claude 等 AI 助手以及 Cursor 等开发者工具集成。

该服务器提供以下工具：

文件操作

list_files: 列出指定目录中的文件
read_file: 读取文件的内容
write_file: 将内容写入文件
delete_file: 删除文件或目录
set_base_directory: 直接从聊天中设置文件操作的基本目录
get_base_directory: 获取当前基本目录

Git 操作

git_command: 在基本目录中执行 git 命令

项目结构

该项目遵循模块化架构，服务按职责组织：

mcp-file-server/
├── services/               # 服务模块
│   ├── configService.js    # 配置管理
│   ├── fileService.js      # 文件系统操作
│   ├── gitService.js       # Git 操作
│   ├── loggerService.js    # 日志功能
│   └── toolService.js      # MCP 工具注册
├── files/                  # 默认存储目录
├── log/                    # 日志文件
├── examples/               # 示例脚本和用法演示
├── mcp_server.js           # 主应用程序入口点
├── package.json            # 项目元数据和依赖项
└── README.md               # 文档

安全特性

强大的路径验证，防止目录遍历攻击
仔细的文件路径规范化和解析
命令验证，防止命令注入
操作记录到专用日志文件中，以便审计
安全处理相对路径

前提条件

Node.js >= 16.0.0
npm 或 yarn 包管理器
Git（用于 git_command 功能）

安装

克隆此存储库：

git clone <repository-url>
cd mcp-file-server

安装依赖项：
```
npm install
```

配置

环境变量

BASE_DIRECTORY: (可选) 文件操作的基本目录的路径。如果未指定，则默认为项目根目录中的 files 目录。

目录结构

/files: 文件操作的默认基本目录
/log: 包含调试日志文件

用法

启动服务器

npm start

用于开发并自动重新加载：

npm run dev

服务器将运行并连接到标准输入/输出进行通信。

从聊天中设置基本目录

此实现的一个关键特性是能够直接从聊天界面设置基本目录。这意味着您无需重新启动服务器或修改配置文件即可更改文件的存储和访问位置。

只需让 AI 助手设置基本目录，例如：

"将基本目录设置为 C:/Users/username/Documents"
"将文件存储位置更改为 /home/user/data"

助手将使用 set_base_directory 工具来更新位置。您可以随时通过询问当前基本目录来验证当前位置。

使用 Git 命令

服务器允许您直接从聊天界面执行 Git 命令。只需让 AI 助手运行 git 命令，例如：

"运行 git status"
"执行 git log --oneline"
"使用 git checkout -b feature/new-feature 创建一个新分支"

您还可以指定要使用的 shell：

"使用 PowerShell，运行 git status"
"在 bash 中，执行 git diff"
"使用 cmd，运行 git pull origin main"

配置对象示例

以下是将 MCP 文件服务器与 Claude Desktop 或 Cursor 集成的配置对象示例：

{
  "mcpServers": {
    "file-server": {
      "command": "node",
      "args": ["/path/to/mcp-file-server/mcp_server.js"],
      "disabled": false,
      "autoApprove": ["list_files", "read_file", "write_file", "delete_file", "set_base_directory", "get_base_directory", "git_command"]
    }
  }
}