mcpignore-filesystem Servidor MCP

¿Qué hace el servidor MCP “mcpignore-filesystem”?

El servidor MCP mcpignore-filesystem es una herramienta basada en Node.js que mejora los flujos de trabajo de desarrollo de asistentes de IA proporcionando un control seguro y granular sobre el acceso al sistema de archivos. Basado en el servidor MCP estándar del sistema de archivos, este servidor introduce soporte para archivos .mcpignore, permitiéndote restringir con cuáles archivos y directorios pueden interactuar tus clientes MCP (como agentes de IA). Al especificar patrones de exclusión similares a .gitignore, puedes proteger datos sensibles y asegurar que solo los archivos autorizados sean accesibles para operaciones como lectura, escritura, gestión de directorios y búsqueda. Este servidor potencia tareas de desarrollo que implican la gestión de archivos, manteniendo estricta seguridad de datos y controles de acceso, por lo que es ideal para equipos que necesiten interfaces robustas y personalizables de sistema de archivos para flujos de trabajo impulsados por IA.

Lista de Prompts

No se mencionan plantillas de prompts en el repositorio.

Lista de Recursos

No se documentan recursos MCP explícitos en el repositorio.

Lista de Herramientas

• read_file: Lee un archivo a menos que coincida con un patrón .mcpignore (Bloqueado para rutas ignoradas).
• read_multiple_files: Lee múltiples archivos a menos que sean ignorados (Bloqueado para rutas ignoradas).
• write_file: Escribe en un archivo a menos que sea ignorado (Bloqueado para rutas ignoradas).
• edit_file: Edita un archivo a menos que sea ignorado (Bloqueado para rutas ignoradas).
• create_directory: Crea un directorio a menos que sea ignorado (Bloqueado para rutas ignoradas).
• list_directory: Lista el contenido de un directorio a menos que sea ignorado (Bloqueado para rutas ignoradas).
• move_file: Mueve archivos o directorios a menos que sean ignorados (Bloqueado para rutas ignoradas).
• get_file_info: Recupera metadatos de archivos a menos que sean ignorados (Bloqueado para rutas ignoradas).
• directory_tree: Recupera la estructura de directorios (Permitido, solo muestra nombres).
• search_files: Busca archivos (Permitido, solo muestra nombres).
• list_allowed_directories: Lista los directorios permitidos para acceso (No aplica para la lógica de exclusión).

Casos de Uso de este Servidor MCP

• Seguridad granular del sistema de archivos: Los desarrolladores pueden ofrecer a los agentes de IA acceso controlado a directorios de proyectos, protegiendo archivos sensibles (por ejemplo, .env, secretos, credenciales) especificándolos en .mcpignore.
• Exploración segura de bases de código: Las herramientas de IA pueden analizar y navegar grandes bases de código asegurando que los archivos confidenciales o propietarios estén excluidos de la exposición.
• Gestión automatizada de archivos: Automatiza tareas rutinarias como organizar, buscar o mover archivos entre directorios, con robustas restricciones de acceso mediante .mcpignore.
• Entornos de desarrollo colaborativo: Expón de forma segura directorios compartidos a asistentes impulsados por IA para edición o búsqueda, bloqueando el acceso a archivos internos o temporales.
• Cumplimiento y auditoría: Aplica cumplimiento de datos asegurando que ciertos tipos de datos o archivos sean inaccesibles para herramientas automatizadas, ayudando en auditoría y gobernanza.

Cómo configurarlo

Windsurf

No se proporcionan instrucciones específicas para Windsurf en el repositorio.

Claude

1. Asegúrate de que Node.js y npx estén instalados.
2. Abre tu claude_desktop_config.json.
3. Agrega la configuración del servidor MCP como se muestra abajo.
4. Guarda el archivo y reinicia Claude.
5. Verifica que el servidor esté en ejecución y accesible.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Protegiendo claves API (ejemplo):

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [ ... ],
      "env": {
        "API_KEY": "${MCP_SERVER_API_KEY}"
      },
      "inputs": {
        "api_key": "${MCP_SERVER_API_KEY}"
      }
    }
  }
}

Cursor

1. Asegúrate de que Node.js y npx estén instalados.
2. Abre tu archivo de configuración mcp.json.
3. Agrega la configuración del servidor como se muestra abajo.
4. Guarda el archivo y reinicia Cursor.
5. Confirma la conectividad con el servidor.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Protegiendo claves API: (ver ejemplo de Claude arriba)

Cline

1. Asegúrate de que Node.js y npx estén instalados.
2. Abre tu cline_mcp_settings.json.
3. Inserta la configuración del servidor.
4. Guarda y reinicia Cline.
5. Comprueba la disponibilidad del servidor.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Protegiendo claves API: (ver ejemplo de Claude arriba)

Windsurf

No se proporcionan instrucciones de configuración.

Cómo usar este MCP dentro de los flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración del sistema MCP, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "mcpignore-filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá utilizar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “mcpignore-filesystem” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Con la información disponible, este servidor MCP ofrece herramientas robustas y claramente documentadas para el sistema de archivos con sólidas funciones de seguridad, pero carece de plantillas de prompts y recursos. Tampoco hay mención explícita de Roots o soporte de muestreo. Por tanto, es una opción sólida para la gestión segura de archivos, pero puede ser menos adecuada para flujos de trabajo que requieran plantillas de prompts o gestión avanzada de recursos.

Puntuación MCP

Valoración:
Calificaría este servidor MCP con un 6/10. Tiene un enfoque claro en la seguridad, herramientas documentadas y licencia, pero carece de plantillas de prompts, definiciones de recursos y evidencia de roots o soporte de muestreo. Su valor es mayor para equipos que buscan acceso seguro al sistema de archivos basado en exclusiones para agentes de IA.