convez.ai
MCP ServerIntegração & APIsIntermediário
LincolnBurrows2017

Filesystem MCP

LincolnBurrows2017/filesystem-mcp

MCP para leitura, escrita e gerenciamento de arquivos locais com Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para operações de sistema de arquivos que permite assistentes IA como Claude e Cursor ler, escrever e gerenciar arquivos locais. Oferece um conjunto completo de ferramentas para manipulação de arquivos com restrições de segurança e modo somente leitura.

Instalação

$npx convez-ai LincolnBurrows2017/filesystem-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
1
Saúde
42%
Último commit
há 8 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar Claude e Cursor com acesso ao sistema de arquivos local
  • Automatizar operações de arquivo em fluxos de IA
  • Permitir que assistentes IA gerenciem projetos e documentos

Veredito

MCP server bem estruturado que viabiliza operações de filesystem para assistentes IA. Implementação sólida com boas práticas de segurança (path restrictions, limits de tamanho) e modo read-only, atendendo casos de uso legítimos de automação e integração.

README

A tradução para o português deste README ainda está na fila.

📂 filesystem-mcp

Model Context Protocol (MCP) server for file system operations. Enable AI assistants like Claude, Cursor, and others to read, write, and manage files on your local system.

🚀 Features

  • 📖 Read files - Read file contents with size limits
  • 📂 List directories - View files with metadata (size, type)
  • ✏️ Write files - Create and update files
  • 🗑️ Delete files - Remove files and directories
  • 🔍 Search files - Glob pattern matching
  • 📊 File info - Get detailed metadata
  • 📁 Directory operations - Create, copy, move directories

📦 Installation

pip install filesystem-mcp

🔧 Usage

CLI Mode

# Start the MCP server (read-write mode)
filesystem-mcp --directory /path/to/your/project

# Start in read-only mode
filesystem-mcp --directory /path/to/your/project --readonly

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "filesystem-mcp",
      "args": ["--directory", "/path/to/your/project"]
    }
  }
}

Cursor

Add to Cursor settings (MCP configuration):

{
  "mcpServers": {
    "filesystem": {
      "command": "filesystem-mcp",
      "args": ["--directory", "/path/to/your/project"]
    }
  }
}

🛠️ Available Tools

ToolDescriptionWrite
read_fileRead contents of a file❌
list_directoryList files in a directory❌
write_fileCreate or write to a file✅
delete_fileDelete a file or directory✅
create_directoryCreate a new directory✅
search_filesSearch files by glob pattern❌
get_file_infoGet file metadata❌
copy_fileCopy a file or directory✅
move_fileMove or rename a file✅

📝 Example

from filesystem_mcp import FileSystemServer

# Create server instance
server = FileSystemServer(root_directory="/path/to/project")

# Run the server
server.run()

🔐 Security

  • Path restrictions: All operations are restricted to the specified root directory
  • File size limits: Maximum 1MB for file reads
  • Optional read-only mode: Use --readonly flag to disable all write operations

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

MIT License - see LICENSE for details.

Ver o original no GitHub

Bom para

Relacionados