MCP 文件系统服务器

免责声明: 这是一个非官方的 Claude 文件系统 MCP 服务器实现的移植版本，仅作为概念验证 (POC) 创建。本项目与 Anthropic 无关，不应在生产环境中使用。它的创建目的是为了演示和探索 MCP 服务器的功能。

原始实现和概念由 Claude (Anthropic) 在交互式会话中演示。此移植版本仅用于教育目的。

快速开始

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 中：

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

安全提示

只有在 args 数组中指定的目录才能被访问。服务器强制执行严格的路径验证，以防止访问允许目录之外的内容。

问题排查

1. 命令未找到：

   • 确保已安装该软件包 (uv pip list)
   • 检查你的 Python 环境是否已激活

2. 访问被拒绝：

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

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

   • 检查你的配置文件语法
   • 在配置更改后重启 Claude Desktop