mcp-workspace

Overview

MCP Workspace Server is a Python-based MCP server that provides secure file system operations within a specified project directory. It enables AI assistants to read, write, edit, and delete files, as well as work with Git repositories and GitHub resources. The server implements strict security measures by restricting all operations to the configured project directory, preventing unauthorized file access. It includes features like structured logging, reference projects for read-only access to additional codebases, and precise file editing capabilities using exact string matching.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• list_directory

  Lists files and directories in the project directory

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

  Reads the contents of a file

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

  Creates or overwrites files atomically

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

  Adds content to existing files

  Try:Add a function to utils.jsTry:Append this log message to error.log
• delete_this_file

  Removes files from the filesystem

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

  Makes selective edits using exact string matching

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

  Moves or renames files and directories

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

  Lists available reference projects

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

  Lists files in a reference project

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

  Reads files from reference projects

  Try:Show me the README from the examples projectTry:Read the documentation file from docs

Comparable tools

Installation

# Clone the repository
git clone https://github.com/MarcusJellinghaus/mcp-workspace.git
cd mcp_workspace

# Create and activate a virtual environment (optional but recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies using pip with 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

How does the server ensure file security?

The server restricts all file operations to the specified project directory. Attempts to access files outside this directory will result in an error. Reference projects provide read-only access only.

Can I use multiple reference projects?

Yes, you can specify multiple reference projects using the --reference-project argument multiple times. Each reference project is read-only and can have a unique name.

What file operations are supported?

The server supports list_directory, read_file, save_file, append_file, delete_this_file, edit_file, and move_file operations, plus special methods for working with reference projects.

Compare mcp-workspace with