MCP 文件系统服务器

免责声明：这是一个 unofficial 的 Claude 文件系统 MCP 服务器实现的端口，仅用于概念验证（POC）。该项目与 Anthropic 无关，不应在生产环境中使用。它旨在演示和探索 MCP 服务器的功能。

快速开始

1. 使用 UVX 安装：

uv venv
.venv\Scripts\activate  # Windows 系统
uv pip install -e .

与 Claude Desktop 配合使用

1. 修改你的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // 替换为你所需的目录
      ]
    }
  }
}

你可以添加多个目录：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/",
        "C:/Users/YourUsername/Documents",
        "~/Desktop"
      ]
    }
  }
}

2. 重启 Claude Desktop 以应用更改

3. 在 Claude Desktop 中：

   • 点击纸clip 图标
   • 选择 MCP 菜单（两个相连的插头图标）
   • 你的文件系统服务器将在集成选项中可用

安全注意

仅允许访问 args 数组中指定的目录。服务器会对路径进行严格的验证，以防止超出允许目录的访问。

故障排除

1. 命令未找到：

   • 确保已安装该包（使用 uv pip list 检查）
   • 确认 Python 环境已激活

2. 访问被拒绝：

   • 验证 args 中的目录是否存在
   • 确保你对指定目录具有读取权限

3. 服务器未显示在 Claude Desktop 中：

   • 检查配置文件语法是否正确
   • 在更改配置后重启 Claude Desktop