MCP 文件系统

一个模型上下文协议 (MCP) 服务器，它为工作目录中的每个文件公开资源并发送更改通知。

状态

⚠️ 预 Beta 质量 ⚠️

“它在我的机器上可以工作”。 欢迎提出问题 ❤️

特性

• 资源: 为您的工作区中的每个文件创建一个 MCP 资源
• Gitignore 支持: 遵循 .gitignore 规则
• 更改通知: 检测文件更改、添加和删除
• MIME 类型检测和编码处理: 识别文件类型并处理各种文本编码

设置

安装 Go：按照 https://golang.org/doc/install 上的说明进行操作

获取或更新此服务器：

go install github.com/isaacphi/mcp-filesystem@latest

将以下内容添加到您的客户端配置（对于 Claude Desktop，位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem",
      "args": ["--workspace", "/path/to/your/repository"]
    }
  }
}

将 /path/to/your/repository 替换为您的项目目录的绝对路径。

用法

您的客户端将能够访问和引用您的存储库中所有未忽略的文件作为 MCP 资源。 每个文件都注册为一个单独的资源，并具有适当的 MIME 类型检测。

客户端要求

您的客户端需要支持以下 MCP 功能：

资源列表：列出和访问服务器公开的资源的能力 更改通知：支持接收 notifications/resources/list_changed 事件 资源内容访问：能够请求和呈现具有适当 MIME 类型的资源内容

关于

本项目使用：

• mcp-golang 用于 MCP 通信
• fsnotify 用于文件系统事件监控
• go-gitignore 用于解析 .gitignore 文件

开发

克隆存储库：

git clone https://github.com/isaacphi/mcp-filesystem.git
cd mcp-filesystem

安装依赖项：

go mod download

构建：

go build

配置您的客户端以使用您的本地构建：

{
  "mcpServers": {
    "filesystem": {
      "command": "/full/path/to/your/mcp-filesystem/mcp-filesystem",
      "args": ["--workspace", "/path/to/repository"],
      "env": {
        "DEBUG": "1"
      }
    }
  }
}

反馈

请提交尽可能详细的问题。

设置 DEBUG 环境变量以启用详细日志记录：

"env": {
  "DEBUG": "1"
}

我关注的功能

• [x] 工作区中每个文件的资源
• [x] .gitignore 支持
• [x] 更改通知
• [ ] 标准化 MCP 协议的使用，以与更多客户端（Claude Desktop）一起使用
• [ ] 可配置的行号支持
• [ ] 资源更新订阅
• [ ] 其他忽略模式（超出 .gitignore）
• [ ] 用于高容量文件更改的防抖通知
• [ ] info、create、edit 和 delete 工具