AI导哈

本地文件系统工具

MCP本地工具提供对指定本地目录的只读访问和自定义功能扩展，适用于Claude Desktop的本地集成。

  • by biguz-commits
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 biguz-commits/mcp-servers

使用说明

MCP本地工具

此存储库包含两个自定义 模型上下文协议（MCP） 设计用于扩展Claude Desktop本地功能的服务器。
该项目使用 紫外线 作为Python包和环境管理器。

📂 工具概述

1. 本地文件系统工具

  • 提供 只读访问 到指定的本地目录。
  • 确保 安全路径分辨率 根限制。
  • 示例功能：
    • list_dir(path) → 列出目录中的文件/文件夹。
    • read_text(path) → 读取文本文件的内容。

环境变量：

MCP_FILES=/Users/**/**/mcp_files

2. 自定义工具

  • 作为MCP服务器实现其他自定义功能。
  • 可用作MCP服务器工具。
  • （用第二个Python文件的描述调整此部分。）

⚙️ 安装

克隆存储库并设置环境：

git clone https://github.com/your-username/mcp-local-tools.git
cd mcp-local-tools

# Create and sync the environment with uv
uv sync

激活环境：

source .venv/bin/activate

▶️ 运行工具

使用以下命令在开发模式下运行任何工具：

uv run mcp dev <your_tool>.py

🖥️ Claude桌面配置

要将这些服务器与Claude Desktop连接，请编辑配置文件：

macOS：
~/Library/Application Support/Claude/claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "local-fs": {
      "command": "uv",
      "args": ["run", "filesystem_tool.py"],
      "env": {
        "MCP_FILES": "/Users/**/**/mcp_files"
      }
    },
    "custom-tool": {
      "command": "uv",
      "args": ["run", "second_tool.py"]
    }
  }
}

保存后，重新启动Claude Desktop。这些工具将显示为可用的MCP端点。

🔒 安全说明

  • 文件系统工具是 沙盒：访问仅限于中定义的目录 MCP_FILES.
  • 与Claude Desktop集成时，始终检查工具权限。
  • 建议使用受限目录（例如项目文件夹）而不是完整的主目录运行。

📖 参考文献

相关 MCP