Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mark3labs/mcp-filesystem-server
Go server implementing Model Context Protocol (MCP) for filesystem operations.
https://github.com/mark3labs/mcp-filesystem-server
Last synced: 2 months ago
JSON representation
Go server implementing Model Context Protocol (MCP) for filesystem operations.
- Host: GitHub
- URL: https://github.com/mark3labs/mcp-filesystem-server
- Owner: mark3labs
- License: mit
- Created: 2024-11-28T12:15:08.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-28T12:37:52.000Z (2 months ago)
- Last Synced: 2024-11-28T13:29:38.258Z (2 months ago)
- Language: Go
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - FileSystem - Golang implementation for local file system access (📂 <a name="file-systems"></a>File Systems)
- awesome-mcp-servers - FileSystem - Golang implementation for local file system access (📂 <a name="file-systems"></a>File Systems)
- awesome-mcp - Filesystem - File operations with configurable access controls. (Servers / Go)
- awesome-mcp-servers - mark3labs/mcp-filesystem-server - ローカルファイルシステムアクセスのためのGolang実装。 (サーバー実装 / 📂 <a name="file-systems"></a>ファイルシステム)
README
# Filesystem MCP Server
Go server implementing Model Context Protocol (MCP) for filesystem operations.
## Features
- Read/write files
- Create/list/delete directories
- Move files/directories
- Search files
- Get file metadata
**Note**: The server will only allow operations within directories specified via `args`.
## API
### Resources
- `file://system`: File system operations interface
### Tools
- **read_file**
- Read complete contents of a file
- Input: `path` (string)
- Reads complete file contents with UTF-8 encoding
- **read_multiple_files**
- Read multiple files simultaneously
- Input: `paths` (string[])
- Failed reads won't stop the entire operation
- **write_file**
- Create new file or overwrite existing (exercise caution with this)
- Inputs:
- `path` (string): File location
- `content` (string): File content
- **create_directory**
- Create new directory or ensure it exists
- Input: `path` (string)
- Creates parent directories if needed
- Succeeds silently if directory exists
- **list_directory**
- List directory contents with [FILE] or [DIR] prefixes
- Input: `path` (string)
- **move_file**
- Move or rename files and directories
- Inputs:
- `source` (string)
- `destination` (string)
- Fails if destination exists
- **search_files**
- Recursively search for files/directories
- Inputs:
- `path` (string): Starting directory
- `pattern` (string): Search pattern
- Case-insensitive matching
- Returns full paths to matches
- **get_file_info**
- Get detailed file/directory metadata
- Input: `path` (string)
- Returns:
- Size
- Creation time
- Modified time
- Access time
- Type (file/directory)
- Permissions
- **list_allowed_directories**
- List all directories the server is allowed to access
- No input required
- Returns:
- Directories that this server can read/write from
## Usage with Claude Desktop
Install the server
```bash
go install github.com/mark3labs/mcp-filesystem-server
```
Add this to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"filesystem": {
"command": "mcp-filesystem-server",
"args": [
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
```
## License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.