MCP Server Filesystem

🚀 MCP 文件系统服务器

本项目是一个未经官方认可的Claude文件系统MCP服务器实现的端口，仅作为概念验证（POC）。它可用于演示和探索MCP服务器功能，但与Anthropic无关，请勿在生产环境中使用。

🚀 快速开始

使用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数组中指定的目录将可访问。服务器会严格执行路径验证，以防止访问允许目录之外的内容。

🛠️ 故障排除

命令未找到

• 确保已安装包，可使用 uv pip list 检查。
• 确认Python环境已激活。

访问被拒绝

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

服务器未在Claude Desktop中显示

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

⚠️ 重要提示

这是一个未经官方认可的Claude文件系统MCP服务器实现的端口，仅作为概念验证（POC），与Anthropic无关，请勿在生产环境中使用。