MCP Filesystem Server

MCP 文件系统服务

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

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

快速开始

1. 使用 UVX 安装：

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

在 Claude Desktop 中使用

1. 编辑你的 claude_desktop_config.json：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // Replace with your desired directory
      ]
    }
  }
}

你可以添加多个目录：

{
  "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