@qpd-v/mcp-delete
A Model Context Protocol (MCP) server that provides file deletion capabilities. This server allows AI assistants to safely delete files when needed, with support for both relative and absolute paths.
Features
- Delete files using relative or absolute paths
- Smart path resolution that tries multiple potential paths
- Clear error messages with detailed path resolution information
- Safe file existence checks before deletion
- Works with Claude and other MCP-compatible AI assistants
Examples
Using with Claude Desktop
Using with VSCode Roo Cline Extension
Installation
Installing via Smithery
To install File Deletion for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @qpd-v/mcp-delete --client claude
Manual Installation
npx @qpd-v/mcp-delete
Or install globally:
npm install -g @qpd-v/mcp-delete
Configuration
Claude Desktop
Add the server configuration to your Claude Desktop config file:
Windows:
// %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
MacOS:
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
}
VSCode Extension
Add the server configuration to your Cline settings:
Windows:
// %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
MacOS:
// ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
}
Available Tools
delete_file
Deletes a file at the specified path.
Parameters:
path(string, required): Path to the file to delete (relative to working directory or absolute)
Example usage in Claude:
You can ask me to delete a file like this:
"Please delete the file example.txt"
I will use the delete_file tool to safely remove the file.
Path Resolution
The server intelligently handles path resolution by trying multiple approaches:
- The exact path as provided
- Path relative to the current working directory
- Path relative to a specified base directory
This makes it more user-friendly as files can be referenced by relative paths and the server will attempt to locate them correctly.
Development
Clone the repository:
git clone https://github.com/qpd-v/mcp-delete.git
cd mcp-delete
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. Use the MCP Inspector for debugging:
npm run inspector
This will provide a URL to access debugging tools in your browser.
License
MIT
Author
qpd-v