mcp-workspace

概述

MCP Workspace Server 是一个基于 Python 的 MCP 服务器，在指定的项目目录中提供安全的文件系统操作。它使 AI 助手能够读取、写入、编辑和删除文件，以及处理 Git 仓库和 GitHub 资源。服务器通过将所有操作限制在配置的项目目录中来实施严格的安全措施，防止未授权的文件访问。它包括结构化日志记录、参考项目（用于对其他代码库进行只读访问）以及使用精确字符串匹配的精确文件编辑功能。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• list_directory

  Lists files and directories in the project directory

  试试:List all files in the src directory试试:Show me what's in the project root
• read_file

  Reads the contents of a file

  试试:Show me the contents of main.js试试:Read the first 10 lines of config.py
• save_file

  Creates or overwrites files atomically

  试试:Create a new file called app.js试试:Save the following code to helper.py
• append_file

  Adds content to existing files

  试试:Add a function to utils.js试试:Append this log message to error.log
• delete_this_file

  Removes files from the filesystem

  试试:Delete the temporary.txt file试试:Remove the old backup file
• edit_file

  Makes selective edits using exact string matching

  试试:Fix the bug in the fetch function试试:Replace 'old_function' with 'new_function' in code.js
• move_file

  Moves or renames files and directories

  试试:Rename config.js to settings.js试试:Move temp.py to the archive folder
• get_reference_projects

  Lists available reference projects

  试试:What reference projects are available?试试:Show me all my reference projects
• list_reference_directory

  Lists files in a reference project

  试试:List files in the docs reference project试试:Show me what's in the examples project
• read_reference_file

  Reads files from reference projects

  试试:Show me the README from the examples project试试:Read the documentation file from docs

可对比工具

安装

# 克隆仓库
git clone https://github.com/MarcusJellinghaus/mcp-workspace.git
cd mcp_workspace

# 创建并激活虚拟环境（可选但推荐）
python -m venv venv
source venv/bin/activate  # 在 Windows 上: venv\Scripts\activate

# 使用 pip 和 pyproject.toml 安装依赖
pip install -e .

mcp-workspace --project-dir /path/to/project [--reference-project NAME=/path/to/reference]... [--log-level LEVEL] [--log-file PATH]

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-workspace",
      "args": [
        "--project-dir",
        "C:\\path\\to\\your\\specific\\project",
        "--reference-project",
        "docs=C:\\path\\to\\documentation"
      ]
    }
  }
}

FAQ

服务器如何确保文件安全性？

服务器将所有文件操作限制在指定的项目目录中。尝试访问此目录之外的文件将导致错误。参考项目仅提供只读访问。

我可以使用多个参考项目吗？

是的，您可以多次使用 --reference-project 参数指定多个参考项目。每个参考项目都是只读的，并且可以有唯一的名称。

支持哪些文件操作？

服务器支持 list_directory、read_file、save_file、append_file、delete_this_file、edit_file 和 move_file 操作，以及用于处理参考项目的特殊方法。

mcp-workspace 对比