MCP Filesystem Server

MCP Filesystem Server

site icon
2025.03.30 0
TypeScript文件系统访问AI 工具集成文件管理
MCP Filesystem Server 是一个基于 Model Context Protocol (MCP) 规范的服务器实现,为 AI 模型和应用程序提供文件系统访问能力。它通过标准化的 JSON-RPC 请求,使 AI 模型能够安全地列出目录内容并与文件系统交互。
View on GitHub

Overview

基本能力

产品定位

MCP Filesystem Server 是一个文件系统访问服务,专为 AI 模型和应用程序设计,提供安全的文件系统交互能力。

核心功能

  • 文件系统访问:列出主机系统上的目录内容
  • JSON-RPC 接口:符合 MCP 规范
  • 安全访问控制:资源访问仅限于特定能力
  • 标准 I/O 传输:使用 stdio 进行通信,便于集成

适用场景

  • AI 模型需要访问本地文件系统时
  • 开发工具(如 Cursor 或 Ollama)需要文件系统集成功能时
  • 需要安全、可控的文件系统访问解决方案时

工具列表

  • list-contents://:列出目录内容(read 能力)
  • file://:文件访问(readwritelist 能力)

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

# 克隆仓库
git clone https://github.com/yourusername/mcp-filesys.git
cd mcp-filesys

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

# 启动服务器
node dist/index.js

# 直接通过命令行交互(示例)
echo '{"jsonrpc":"2.0","id":1,"method":"resources/read","params":{"uri":"list-contents://","parameters":{"path":"/Users"}}}' | node dist/index.js

开发

# 清理构建文件
npm run clean

# 构建项目
npm run build

# 启动服务器
node dist/index.js

许可证

该项目遵循 MIT 开源许可条款。