Filesystem MCP 🌐

Filesystem MCP 🌐

site icon
2025.04.18 0
HTML文件系统访问AI 代理支持文件管理
Filesystem MCP 是一个基于 Node.js 的 Model Context Protocol (MCP) 服务器,旨在为 AI 代理(如 Cline 和 Claude)提供安全、相对的文件系统访问。该项目具有安全访问、相对路径支持、AI 代理专用设计等特点,适用于需要安全文件系统访问的场景。
View on GitHub

Overview

基本能力

产品定位

Filesystem MCP 是一个专为 AI 代理设计的文件系统访问服务,提供安全、相对路径的文件系统操作能力。

核心功能

  • 安全访问:确保 AI 代理以安全的方式与文件系统交互。
  • 相对路径:简化文件访问过程,无需使用绝对路径。
  • AI 代理支持:专门为 Cline 和 Claude 设计。
  • Node.js 构建:利用 Node.js 进行高效的服务器端操作。
  • TypeScript 支持:提供类型安全和更好的开发体验。

适用场景

  • AI 代理需要安全访问文件系统的场景。
  • 需要简化文件路径管理的开发环境。
  • 需要与 Cline 和 Claude 集成的应用。

工具列表

  • npm:用于安装和管理依赖。
  • Node.js:运行环境。
  • Git:用于克隆仓库和版本控制。

常见问题解答

  • 404 Not Found:请求的文件不存在。
  • 403 Forbidden:访问文件被拒绝。

使用教程

使用依赖

  1. 确保已安装 Node.js(v16.0.0 或更高版本)。

安装教程

  1. 克隆仓库: bash git clone https://github.com/Tabeeh/filesystem-mcp.git cd filesystem-mcp
  2. 安装依赖: bash npm install
  3. 下载最新版本: 从 Releases 下载并执行。

调试方式

  1. 启动服务器: bash npm start
  2. 使用 curl 测试 API: bash curl -X GET http://localhost:3000/files/path/to/your/file
  3. 检查日志和错误信息。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。