MCP-Delete
by qpd-v
# @qpd-v/mcp-delete
[](https://smithery.ai/server/@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](https://smithery.ai/server/@qpd-v/mcp-delete):
```bash
npx -y @smithery/cli install @qpd-v/mcp-delete --client claude
```
### Manual Installation
```bash
npx @qpd-v/mcp-delete
```
Or install globally:
```bash
npm install -g @qpd-v/mcp-delete
```
## Configuration
### Claude Desktop
Add the server configuration to your Claude Desktop config file:
Windows:
```json
// %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
```
MacOS:
```json
// ~/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:
```json
// %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
"mcpServers": {
"mcp-delete": {
"command": "npx",
"args": ["@qpd-v/mcp-delete"]
}
}
}
```
MacOS:
```json
// ~/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:
```bash
git clone https://github.com/qpd-v/mcp-delete.git
cd mcp-delete
```
Install dependencies:
```bash
npm install
```
Build the server:
```bash
npm run build
```
For development with auto-rebuild:
```bash
npm run watch
```
### Debugging
Since MCP servers communicate over stdio, debugging can be challenging. Use the MCP Inspector for debugging:
```bash
npm run inspector
```
This will provide a URL to access debugging tools in your browser.
## License
MIT
## Author
qpd-v