https://github.com/qpd-v/mcp-delete
A Model Context Protocol (MCP) server that provides file deletion capabilities for AI assistants. Supports both relative and absolute paths with smart path resolution, making it easy for AI assistants to safely delete files when needed.
https://github.com/qpd-v/mcp-delete
Last synced: 3 months ago
JSON representation
A Model Context Protocol (MCP) server that provides file deletion capabilities for AI assistants. Supports both relative and absolute paths with smart path resolution, making it easy for AI assistants to safely delete files when needed.
- Host: GitHub
- URL: https://github.com/qpd-v/mcp-delete
- Owner: qpd-v
- License: apache-2.0
- Created: 2024-12-14T05:03:40.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-05T22:05:28.000Z (7 months ago)
- Last Synced: 2025-05-31T21:23:20.251Z (4 months ago)
- Language: JavaScript
- Size: 240 KB
- Stars: 1
- Watchers: 1
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - File Deletion - Provides file deletion capabilities, supporting both relative and absolute paths with smart path resolution and existence checks to ensure safe file removal. (Security)
README
# @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