File Explorer MCP

Este proyecto es una implementación didáctica de un servidor y cliente que utilizan el protocolo MCP (Multi-Client Protocol) sobre JSON-RPC 2.0 para explorar archivos y carpetas de manera programática.

- file_explorer_server.py: Un servidor que expone herramientas ("tools") para listar archivos y directorios usando el protocolo MCP. Responde a mensajes JSON-RPC por la entrada/salida estándar (stdio).
- file_explorer_client.py: Un cliente sencillo que se comunica con el servidor, envía solicitudes y muestra las respuestas.

¿Cómo usan MCP el servidor y el cliente?

- Implementa el protocolo MCP completo
- Expone herramientas ("tools") que siguen la especificación MCP
- Responde a mensajes JSON-RPC 2.0 con los métodos MCP estándar:

- initialize- Inicialización del servidor
- tools/list- Lista las herramientas disponibles
- tools/call- Ejecuta una herramienta específica

- Es un cliente MCP simple y autónomo
- Se comunica con el servidor usando el protocolo MCP
- Lanza el servidor como subproceso y se comunica con él
- No necesitamcp.jsonporque maneja la conexión directamente

- El cliente es un "cliente MCP completo" que maneja todo por sí mismo
- Los clientes que necesitanmcp.jsonson clientes MCP más avanzados (como IDEs) que quieren descubrir y conectar con múltiples servidores MCP de forma automática

Ambos usan MCP, pero el cliente es autosuficiente y no necesita configuración externa.

Permite explorar el sistema de archivos de manera estructurada y automatizada, usando un protocolo estándar. Es útil para aprender sobre:

- Comunicación entre procesos
- Protocolos de mensajes (JSON-RPC)
- Automatización de tareas de exploración de archivos

Abre una terminal en la carpeta del proyecto y ejecuta:

python3 file_explorer_client.py [ruta/opcional]

- Si no pasas ningún argumento, listará el directorio actual.
- Si pasas una ruta como argumento, listará los archivos y carpetas de esa ruta.

python3 file_explorer_client.py /ruta/que/quieras

- Iniciará el servidor como un subproceso.
- Enviará una solicitud de inicialización (initialize).
- Pedirá la lista de herramientas disponibles (tools/list).
- Usará la herramientalist_filespara listar los archivos y carpetas del directorio indicado (o el actual si no se pasa argumento).
- Mostrará todas las respuestas en pantalla en formato JSON.

- initialize: Devuelve información sobre el servidor y el protocolo soportado.
- tools/list: Muestra las herramientas disponibles y los argumentos que aceptan.
- tools/call: Ejecuta una herramienta (por ejemplo,list_files) y devuelve el resultado, que puede ser una lista de archivos y carpetas.

{ "jsonrpc": "2.0", "id": 3, "result": { "content": [ { "type": "text", "text": "Contents of '.':\n\nDirectories:\n DIR: .cursor\n\nFiles:\n FILE: file_explorer_client.py\n FILE: file_explorer_server.py\n" } ] } }

- Directories: Listado de carpetas (DIR:).
- Files: Listado de archivos (FILE).

Puedes modificar el cliente para explorar otras rutas cambiando el argumento de línea de comandos al ejecutarlo:

python3 file_explorer_client.py otra/carpeta

- El cliente y el servidor se comunican usando JSON-RPC 2.0 por stdio.
- El servidor expone herramientas que el cliente puede descubrir y utilizar dinámicamente.
- El flujo es: inicializar → descubrir herramientas → llamar herramientas → mostrar resultados.

El archivomcp.jsones un archivo de configuración que define los servidores MCP disponibles para un cliente. Se ubica típicamente en:

- macOS/Linux:~/.cursor/mcp.json
- Windows:%APPDATA%\mcp.json

{ "mcpServers": { "file_explorer": { "command": "python3", "args": ["[ruta-completa]file_explorer/file_explorer_server.py"], "env": {} } } }

- Descubrimiento automático: Los clientes MCP buscan automáticamente este archivo para encontrar servidores disponibles.
- Configuración centralizada: Permite configurar múltiples servidores MCP desde un solo lugar.
- Integración con IDEs: Muchos editores de código (VS Code, Cursor, etc.) pueden usar esta configuración para integrar herramientas MCP.
- Herramientas dinámicas: Una vez configurado, las herramientas del servidor estarán disponibles en el IDE sin necesidad de ejecutar manualmente el cliente.

Para integrar este servidor de exploración de archivos con un cliente MCP:
- Crea o edita el archivo~/.cursor/mcp.json
- Añade la configuración del servidor con la ruta completa afile_explorer_server.py
- Reinicia tu IDE o cliente MCP

{ "mcpServers": { "file_explorer": { "command": "python3", "args": ["[ruta-completa]file_explorer/file_explorer_server.py"], "env": {} } } }

Una vez configurado, podrás usar las herramientas de exploración de archivos directamente desde tu IDE o cliente MCP preferido.

Visualize directory structures with real-time updates, configurable depth, and smart exclusions for efficient project navigation.

Provides essential utility tools for text processing, file operations, and system tasks.

An MCP server for local file management and system operations.

Provides utility functions for common tasks like text processing, encoding, decoding, hashing, and system information.

Cross-platform MCP server for system clipboard access. Three tools: get_clipboard, set_clipboard, watch_clipboard. Single Rust binary, zero runtime deps.

🧿 One MCP for developers - No tool tax, no context rot. 100+ tools including Brave, Gemini, Context7, Version Checker, Excel, File Ops, Database, Chrome DevTools.

A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.

Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.

An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.

A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.