A Model Context Protocol (MCP) server that provides filesystem operations for Claude AI
What is ai yliu filesystem mcp server
Filesystem MCP Server
A Model Context Protocol (MCP) server that provides filesystem operations for Claude AI.
Features
This MCP server provides the following filesystem operations:
-
read_file: Read complete contents of a file
- Input:
path
(string) - Reads complete file contents with UTF-8 encoding
- Input:
-
read_multiple_files: Read multiple files simultaneously
- Input:
paths
(string[]) - Failed reads won't stop the entire operation
- Input:
-
write_file: Create new file or overwrite existing
- Inputs:
path
(string): File locationcontent
(string): File content
- Inputs:
-
create_directory: Create new directory or ensure it exists
- Input:
path
(string) - Creates parent directories if needed
- Succeeds silently if directory exists
- Input:
-
list_directory: List directory contents with [FILE] or [DIR] prefixes
- Input:
path
(string)
- Input:
-
move_file: Move or rename files and directories
- Inputs:
source
(string)destination
(string)
- Fails if destination exists
- Inputs:
-
search_files: Recursively search for files/directories
- Inputs:
path
(string): Starting directorypattern
(string): Search pattern
- Case-insensitive matching
- Returns full paths to matches
- Inputs:
-
get_file_info: Get detailed file/directory metadata
- Input:
path
(string) - Returns:
- Size
- Creation time
- Modified time
- Access time
- Type (file/directory)
- Permissions
- Input:
-
list_allowed_directories: List all directories the server is allowed to access
- No input required
- Returns directories that this server can read/write from
Security
The server only allows operations within directories specified via command-line arguments.
Installation
- Clone this repository
- Install dependencies:
npm install
- Build the project:
npm run build
Usage
Run the server with one or more allowed directories:
node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2
MCP Configuration
Add the server to your MCP configuration file:
{
"mcpServers": {
"filesystem-server": {
"command": "node",
"args": [
"/path/to/filesystem-server/build/index.js",
"/path/to/allowed/dir1",
"/path/to/allowed/dir2"
],
"disabled": false,
"autoApprove": []
}
}
}
License
ISC
Leave a Comment
Frequently Asked Questions
What is MCP?
MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications, providing a standardized way to connect AI models to different data sources and tools.
What are MCP Servers?
MCP Servers are lightweight programs that expose specific capabilities through the standardized Model Context Protocol. They act as bridges between LLMs like Claude and various data sources or services, allowing secure access to files, databases, APIs, and other resources.
How do MCP Servers work?
MCP Servers follow a client-server architecture where a host application (like Claude Desktop) connects to multiple servers. Each server provides specific functionality through standardized endpoints and protocols, enabling Claude to access data and perform actions through the standardized protocol.
Are MCP Servers secure?
Yes, MCP Servers are designed with security in mind. They run locally with explicit configuration and permissions, require user approval for actions, and include built-in security features to prevent unauthorized access and ensure data privacy.
Related MCP Servers
chrisdoc hevy mcp
sylphlab pdf reader mcp
An MCP server built with Node.js/TypeScript that allows AI agents to securely read PDF files (local or URL) and extract text, metadata, or page counts. Uses pdf-parse.
aashari mcp server atlassian bitbucket
Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.
aashari mcp server atlassian confluence
Node.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.
prisma prisma
Next-generation ORM for Node.js & TypeScript | PostgreSQL, MySQL, MariaDB, SQL Server, SQLite, MongoDB and CockroachDB
Zzzccs123 mcp sentry
mcp sentry for typescript sdk
zhuzhoulin dify mcp server
zhongmingyuan mcp my mac
zhixiaoqiang desktop image manager mcp
MCP 服务器,用于管理桌面图片、查看详情、压缩、移动等(完全让Trae实现)
zhixiaoqiang antd components mcp
An MCP service for Ant Design components query | 一个减少 Ant Design 组件代码生成幻觉的 MCP 服务,包含系统提示词、组件文档、API 文档、代码示例和更新日志查询
Submit Your MCP Server
Share your MCP server with the community
Submit Now