MCP Filesystem Server

MCP Filesystem Server

site icon
2024.12.27 0
Python文件系统访问概念验证其它
philgei_mcp_server_filesystem 是一个非官方的文件系统 MCP 服务器实现,主要用于概念验证(POC)。该项目与 Anthropic 无关,不建议在生产环境中使用。其主要功能是提供一个文件系统访问接口,允许用户通过 Claude Desktop 访问指定的目录。
View on GitHub

Overview

基本能力

产品定位

philgei_mcp_server_filesystem 是一个用于文件系统访问的 MCP 服务器,主要用于教育和概念验证目的。

核心功能

  • 提供文件系统访问接口
  • 支持多目录配置
  • 严格的路径验证,防止访问未授权的目录

适用场景

  • 教育和概念验证
  • 通过 Claude Desktop 访问本地文件系统

工具列表

  • mcp-server-filesystem: 主服务工具,用于启动文件系统 MCP 服务器

常见问题解答

  1. Command not found: 确保包已安装 (uv pip list),并检查 Python 环境是否激活。
  2. Access denied: 验证 args 中的目录是否存在,并确保有读取权限。
  3. Server not showing in Claude Desktop: 检查配置文件语法,并在更改后重启 Claude Desktop。

使用教程

使用依赖

  1. 安装 UVX:
uv venv
.venv\Scripts\activate  # On Windows

安装教程

  1. 安装包:
uv pip install -e .

调试方式

  1. 编辑 claude_desktop_config.json:
{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // 替换为你的目录
      ]
    }
  }
}
  1. 重启 Claude Desktop 以应用更改。
  2. 在 Claude Desktop 中,点击回形针图标,选择 MCP 菜单,即可看到文件系统服务器。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。