@qpd-v/mcp-delete

View original on GitHub 

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

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:

1. The exact path as provided
2. Path relative to the current working directory
3. 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