https://github.com/tkc/claude-desktop-mcp
https://github.com/tkc/claude-desktop-mcp
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tkc/claude-desktop-mcp
- Owner: tkc
- Created: 2025-03-14T16:04:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-07T02:18:36.000Z (about 1 year ago)
- Last Synced: 2025-10-30T02:16:05.869Z (9 months ago)
- Language: TypeScript
- Size: 62.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **claude-desktop-mcp** - TypeScript-based `typescript` `npm install tkc/claude-desktop-mcp` (🌐 Web Development)
README
# Claude Desktop MCP Server
A filesystem Model Context Protocol (MCP) server implementation for Claude Desktop. This server provides filesystem capabilities to Claude, allowing it to read, write, and manipulate files on your system.
## Features
- List files with glob pattern matching
- Read file contents
- Write to files
- Edit files with diff output
- Delete files
- Secure path normalization to prevent directory traversal attacks
## Prerequisites
- [Bun](https://bun.sh) v1.2.5 or later
## Installation
Clone the repository and install dependencies:
```bash
git clone https://github.com/yourusername/claude-desktop-mcp.git
cd claude-desktop-mcp
bun install
```
## Usage
Run the MCP server:
```bash
bun run index.ts [base-directory]
```
If no base directory is provided, the current working directory will be used.
## Available Tools
The server exposes the following tools:
- `list_files`: Lists files matching a glob pattern
- `read_file`: Reads the content of a file
- `write_file`: Writes content to a file
- `edit_file`: Edits an existing file with the provided content and shows diff
- `delete_file`: Deletes a file
## Security
The server implements path normalization and validation to ensure that operations are restricted to the specified base directory, preventing directory traversal attacks.
## License
MIT
## Acknowledgments
- Based on the [Model Context Protocol](https://modelcontextprotocol.io/) specification
- Built with [Bun](https://bun.sh) JavaScript runtime