MCP File System Server
About
MCP Workspace Server: A secure Model Context Protocol server providing file, git, and GitHub tools for AI assistants within a sandboxed project directory.
Details
- Author
- MarcusJellinghaus
- GitHub stars
- 49
- Downloads
- 1,763
- Categories
- Other
Jump to
- Directory listing with gitignore filtering and exclusion of .git folders
- Reading files with optional line ranges and line numbers
- Atomic file creation/overwrite with save_file
- Append content to existing files with append_file
- Precise text editing using exact string matching (edit_file)
- Move or rename files/directories within the project
- Read‑only access to multiple external reference projects
- Structured logging in both human‑readable and JSON formats
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP File System ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install by cloning the repository and running pip install -e . in the project directory. Start the server with mcp-workspace --project-dir /path/to/project and optional arguments for reference projects, logging level, log file path, and file size limit. For Claude Desktop integration, add the server configuration to claude_desktop_config.json with the mcp-workspace command and required --project-dir argument.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp file system server": {
"mcp_server_filesystem": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"mcp_server_filesystem": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}MCP File System Server
A simple Model Context Protocol (MCP) server providing file system operations. This server offers a clean API for performing file system operations within a specified project directory, following the MCP protocol design.
Overview
This MCP server enables AI assistants like Claude (via Claude Desktop) or other MCP-compatible systems to interact with your local file system. With these capabilities, AI assistants can:
- Read your existing code and project files
- Write new files with generated content
- Update and modify existing files with precision using exact string matching
- Make selective edits to code without rewriting entire files
- Delete files when needed
- Review repositories to provide analysis and recommendations
- Debug and fix issues in your codebase
- Generate complete implementations based on your specifications
All operations are securely contained within your specified project directory, giving you control while enabling powerful AI collaboration on your local files.
By connecting your AI assistant to your filesystem, you can transform your workflow from manual coding to a more intuitive prompting approach - describe what you need in natural language and let the AI generate, modify, and organize code directly in your project files.
Features
- list_directory: List all files and directories in the project directory
- read_file: Read the contents of a file
- save_file: Write content to a file atomically
- append_file: Append content to the end of a file
- delete_this_file: Delete a specified file from the filesystem
- edit_file: Make selective edits using exact string matching
- move_file: Move or rename files and directories within the project
- get_reference_projects: Discover available reference projects
- list_reference_directory: List files in reference projects
- read_reference_file: Read files from reference projects
- Structured Logging: Comprehensive logging system with both human-readable and JSON formats
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
