philgei_mcp_server_filesystem

🚀 MCP 文件系统服务器

本项目是一个非官方的 Claude 文件系统 MCP 服务器实现的端口，仅用于概念验证（POC）。它与 Anthropic 无关，不可用于生产环境，主要用于演示和探索 MCP 服务器的功能。

🚀 快速开始

安装步骤

使用 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。