Filesystem MCP Server

简介

文件系统 MCP 服务器提供标准化的文件系统操作、分析和处理功能，基于模型上下文协议(MCP)构建。

安装步骤

# 1. 克隆仓库
git clone <repository-url>
cd filesystem-server

# 2. 安装依赖
npm install

# 3. 构建服务器
npm run build

# 4. 配置 MCP 设置 (cline_mcp_settings.json)

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

核心功能

文件操作

// 读取文件
{
  "path": "example.txt",
  "encoding": "utf8"
}

// 写入文件
{
  "path": "example.txt", 
  "content": "Hello world",
  "encoding": "utf8"
}

// 追加内容
{
  "path": "example.txt",
  "content": "Additional content",
  "encoding": "utf8"
}

目录操作

// 列出目录内容
{
  "path": "./src",
  "recursive": false
}

// 创建目录
{
  "path": "new-directory",
  "recursive": true
}

分析功能

// 分析文本文件
{
  "path": "example.txt"
}

// 计算文件哈希
{
  "path": "example.txt",
  "algorithm": "sha256"
}

// 查找重复文件
{
  "path": "./documents"
}

压缩操作

// 创建ZIP文件
{
  "files": ["file1.txt", "file2.txt"],
  "output": "archive.zip"
}

// 解压ZIP文件
{
  "path": "archive.zip",
  "output": "./extracted"
}

开发

# 运行测试
npm test

# 代码检查
npm run lint

# 开发模式
npm run watch

项目结构

src/
├── operations/     # 核心操作实现
├── tools/          # MCP 工具定义
├── __tests__/      # 测试套件
├── index.ts        # 入口点
└── server.ts       # 服务器设置

错误处理

服务器返回标准MCP错误代码，包含人类可读消息和上下文信息。

许可证

MIT