MCP 文件服务器

一个通过标准化接口提供文件系统操作的模型上下文协议（MCP）服务器实现。

概述

MCP 文件服务器允许 AI 模型通过标准化 API 在本地文件系统上执行文件操作。它使用 Model Context Protocol SDK 构建，并提供了读取、创建和列出文件的工具。

功能

• 创建文件：创建具有指定内容的新文件
• 读取文件：读取现有文件的内容
• 列出目录内容：列出带有详细信息的文件和目录
• 性能监控：内置 Sentry 集成用于错误跟踪和性能监控

安装

npm install

使用

启动 MCP 文件服务器：

node src/index.js

该服务器通过 stdin/stdout 以 MCP 协议进行通信。

可用工具

createfile

在指定路径下使用提供的内容创建新文件。

参数：

• filePath：应创建文件的路径
• content：要写入文件的内容

返回：

• 包含文件路径和大小信息的成功消息

readfile

读取指定路径下的文件内容。

参数：

• filePath：要读取的文件路径

返回：

• 文件的内容

listfiles

列出指定路径下的文件和目录。

参数：

• path：要列出内容的目录路径

返回：

• 包含文件名、大小和类型的 markdown 表格

环境变量

• SENTRY_DSN：用于错误跟踪的 Sentry 数据源名称（可选）

依赖项

• @modelcontextprotocol/sdk：MCP SDK 包
• zod：模式验证
• @sentry/node：错误跟踪和性能监控

示例

通过 MCP 协议调用这些工具的示例：

{
  "name": "createfile",
  "params": {
    "filePath": "example/test.txt",
    "content": "Hello, world!"
  }
}

{
  "name": "readfile",
  "params": {
    "filePath": "example/test.txt"
  }
}

{
  "name": "listfiles",
  "params": {
    "path": "example"
  }
}