文件系统 MCP 服务器

模型上下文协议 (MCP) 服务器实现通过标准化工具接口提供文件系统操作、分析和操控功能。

建筑学

该服务器基于 MCP SDK 构建，并分为不同的层：

graph TD A[MCP Server Layer] --> B[Tool Registry] B --> C[Operations Layer] C --> D[File System Operations] C --> E[Analysis Operations] C --> F[Stream Operations]

成分

服务器层：处理MCP协议通信和工具调度
工具注册表：管理工具注册和执行
操作层：实现核心功能
文件系统接口：提供安全的文件系统访问

安装

克隆存储库：

git clone <repository-url> cd filesystem-server

安装依赖项：

npm install

构建服务器：

npm run build

配置 MCP 设置（cline_mcp_settings.json）：

{ "mcpServers": { "filesystem": { "command": "node", "args": ["path/to/filesystem-server/build/index.js"] } } }

工具参考

目录操作

列表目录

列出带有元数据的目录内容。

interface ListDirectoryParams { path: string; // Directory path recursive?: boolean; // List recursively (default: false) } interface ListDirectoryResult { entries: { name: string; path: string; isDirectory: boolean; size: number; created: string; modified: string; accessed: string; mode: string; }[]; }

创建目录

创建新目录。

interface CreateDirectoryParams { path: string; // Directory path recursive?: boolean; // Create parent directories (default: true) }

文件操作

读取文件

读取具有编码支持的文件内容。

interface ReadFileParams { path: string; // File path encoding?: string; // File encoding (default: 'utf8') }

写入文件

将内容写入文件。

interface WriteFileParams { path: string; // File path content: string; // Content to write encoding?: string; // File encoding (default: 'utf8') }

追加文件

将内容附加到文件。

interface AppendFileParams { path: string; // File path content: string; // Content to append encoding?: string; // File encoding (default: 'utf8') }

分析操作

分析文本

分析文本文件属性。

interface AnalyzeTextParams { path: string; // File path } interface AnalyzeTextResult { lineCount: number; wordCount: number; charCount: number; encoding: string; mimeType: string; }

计算哈希

使用指定的算法计算文件哈希值。

interface CalculateHashParams { path: string; // File path algorithm?: 'md5' | 'sha1' | 'sha256' | 'sha512'; // Hash algorithm } interface CalculateHashResult { hash: string; algorithm: string; }

查找重复项

识别目录中的重复文件。

interface FindDuplicatesParams { path: string; // Directory path } interface FindDuplicatesResult { duplicates: { hash: string; size: number; files: string[]; }[]; }

压缩操作

创建_zip

创建一个 ZIP 档案。

interface CreateZipParams { files: string[]; // Files to include output: string; // Output ZIP path }

提取压缩文件

提取 ZIP 档案。

interface ExtractZipParams { path: string; // ZIP file path output: string; // Output directory }

错误处理

服务器使用标准 MCP 错误代码：

enum ErrorCode { ParseError = -32700, InvalidRequest = -32600, MethodNotFound = -32601, InvalidParams = -32602, InternalError = -32603 }

错误响应包括：

错误代码
人类可读的消息
附加上下文（如有）

错误示例：

{ "code": -32602, "message": "File not found: /path/to/file.txt" }

发展

项目结构

src/ ├── operations/ # Core operations implementation ├── tools/ # MCP tool definitions and handlers ├── __tests__/ # Test suites ├── index.ts # Entry point ├── server.ts # MCP server setup ├── types.ts # Type definitions └── utils.ts # Utility functions

运行测试

运行测试套件：

npm test

覆盖运行：

npm run test:coverage

开发模式

以监视模式运行：

npm run watch

代码质量

检查代码库：

npm run lint

类型检查：

npm run type-check

依赖项

核心依赖项：

@modelcontextprotocol/sdk：MCP 服务器实现
file-type：文件类型检测
mime-types：MIME 类型查找
crypto-js：文件哈希
归档器：ZIP 创建
extract-zip：ZIP 提取
iconv-lite：文本编码
chardet：编码检测

开发依赖项：

typescript：类型系统
开玩笑：测试
eslint：Lint
更漂亮：格式化
ts-node：TypeScript 执行
nodemon：开发服务器

贡献

分叉存储库
创建你的功能分支
为新功能编写测试
确保所有测试通过
提交拉取请求

执照

麻省理工学院

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion about this server

Related MCP Servers

File Operations MCP Server
bsmi021
A
security
A
license
A
quality
A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
Last updated -
19
MIT License
MCP Filesystem Server
safurrier
A
security
A
license
A
quality
A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
Last updated -
21
50
MIT License
MCP File System
Wayazi
A
security
A
license
A
quality
A server implementing the Model Context Protocol that provides filesystem operations (read/write, directory management, file movement) through a standardized interface with security controls for allowed directories.
Last updated -
9
3
MIT License
Enhanced File Operations MCP Server
SkippyzNJiff
-
security
F
license
-
quality
A comprehensive Model Context Protocol server that provides over 50 file and system management tools for AI models, including navigation, file operations, search, compression, and system information capabilities.
Last updated -

View all related MCP servers

Filesystem MCP Server