The Node Dev MCP Server is a lightweight server for local workspace file operations, git version control, and Node.js project management.
File Operations: Read, write, and delete files within the workspace
Folder Management: Create, delete, copy, and list directories
Search Functionality: Search file contents using ripgrep and find files/folders using regular expressions
Version Control: Check repository status, view diffs, show commit logs, apply unified diff patches, and track changes
Dependency Management: Install all project dependencies or individual packages
Script Execution: Run build scripts and custom npm scripts (e.g., test, lint)
Workflow Initialization: Bootstrap new feature branches with start_work (sets remote URL, pulls changes, creates/pushes branches, and installs dependencies)
Git Integration: All file/folder operations can include automatic git commits with custom messages
Environment Requirements: Requires PROJECT_REPO and GITHUB_TOKEN environment variables for git authentication. All operations are scoped to the workspace folder for security, and command outputs are trimmed to the last 300 lines for long results.
Provides tools for managing local repositories, including checking status, viewing diffs, and accessing commit logs.
Supports remote repository operations such as setting remote URLs and pushing changes using GitHub tokens.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Node Dev MCP Serverstart a new branch called 'feature-login' and install dependencies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Node Dev MCP Server
Lightweight MCP server for local workspace file operations and git commands.
Tools
Tool | Description | Input (JSON) |
start_work | Set remote URL from env, pull latest changes, create and push a branch, and install dependencies |
|
read_file | Read the content of a file in the workspace folder |
|
write_file | Write content to a file in the workspace folder |
|
delete_file | Delete a file from the workspace folder |
|
create_folder | Create a folder in the workspace folder |
|
delete_folder | Delete a folder from the workspace folder |
|
copy_folder | Copy a folder in the workspace folder |
|
search_content | Search file contents in the workspace using ripgrep (rg) |
|
apply_patch | Apply a unified diff patch in the workspace |
|
search_entries | Search for files and folders in the workspace using a regular expression |
|
list_dir | List files and folders in the workspace folder or a subfolder |
|
vcs_status | Get the status of the repository |
|
vcs_diff | Get repository diff |
|
vcs_log | Show commit log |
|
install_dependencies | Install all dependencies in the workspace |
|
install_package | Install a single package in the workspace |
|
run_build | Run the build script in the workspace |
|
run_script | Run a script in the workspace |
|
Notes:
PROJECT_REPOandGITHUB_TOKENmust be set so git remote/push operations can authenticate.currentWorkingDirectorymust resolve to a directory inside the workspace root. Use.for the workspace root.Command tools include stdout/stderr in responses and trim long output to the last 300 lines.