MCP 文件服务器

一个基于 Model Context Protocol (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"
  }
}