Servidor MCP de Escritura de Archivos

Una implementación en Node.js del Protocolo de Contexto de Modelo (MCP) diseñada para operaciones de archivo fluidas dentro de LM Studio y otros entornos compatibles con MCP. Este servidor proporciona una interfaz robusta para que los modelos de lenguaje grandes creen, añadan y gestionen archivos en múltiples formatos, incluyendo texto plano, Markdown, CSV y Microsoft Excel (XLSX).

Características

• Soporte multiformato: Maneja la transformación de datos para archivos .txt, .md, .csv y .xlsx.

• Procesamiento de datos estructurados: Acepta datos de tabla como objetos JSON y los convierte automáticamente al formato solicitado.

• Modos de escritura flexibles:

  • Añadir (Predeterminado): Agrega nuevos datos al final de los archivos existentes.

  • Sobrescribir: Reemplaza los archivos existentes con nuevo contenido.

  • Copia de seguridad numerada: Preserva los datos existentes creando versiones incrementadas (p. ej., file.1.csv).

• Enfocado en la seguridad: Restringe todas las operaciones de archivo a un directorio raíz especificado por el usuario para evitar el recorrido de rutas no autorizado.

• Integración con Excel: Utiliza ExcelJS para la generación de alta fidelidad de archivos de hoja de cálculo binarios.

Related MCP server: Excel MCP Server

Instalación

Requisitos previos

• Node.js (v18 o superior)

• npm

Configuración

1. Clona el repositorio o copia los archivos fuente a tu máquina local.

2. Instala las dependencias requeridas:

   npm install

3. Construye el proyecto:

   npm run build

Configuración para LM Studio

Para usar este servidor en LM Studio, añádelo a tus ajustes de MCP con la siguiente configuración:

{
  "mcpServers": {
    "file-writer": {
      "command": "node",
      "args": [
        "C:/Users/szpon/file_writer_mcp/dist/index.js",
        "--root",
        "C:/your/default/directory"
      ]
    }
  }
}

Argumentos

• --root <path>: (Obligatorio) La ruta absoluta al directorio predeterminado para operaciones de archivo relativas.

• --overwrite: (Opcional/Legado) Proporcionado para compatibilidad con configuraciones antiguas; se ignora en favor de la selección de herramientas.

• --backup: (Opcional/Legado) Proporcionado para compatibilidad con configuraciones antiguas; se ignora en favor de la selección de herramientas.

Uso de herramientas

El servidor proporciona tres herramientas distintas para darte un control claro sobre el manejo de archivos directamente desde la barra lateral de LM Studio:

1. write_file: Úsala para operaciones estándar. Añade datos a archivos existentes o los crea si no existen.

2. write_file_overwrite: Úsala para reemplazar completamente un archivo existente con nuevos datos.

3. write_file_backup: Úsala para guardar datos mientras preservas el original. Si el archivo existe, crea una copia de seguridad numerada (p. ej., data.1.csv).

Argumentos de las herramientas

• path (string): El nombre del archivo o la ruta absoluta completa. Si se proporciona una ruta relativa, se resuelve respecto al directorio --root. Si se proporciona una ruta absoluta, el servidor escribe directamente en esa ubicación.

• format (string): La extensión de archivo deseada (txt, md, csv o xlsx).

• data (object):

  • headers (string[]): Nombres de columna para formatos de tabla.

  • rows (any[][]): El conjunto de datos a escribir.

  • content (string, opcional): Contenido de texto plano para archivos .txt.

Desarrollo

Ejecución de pruebas

El proyecto utiliza Vitest para pruebas unitarias. Para ejecutar el conjunto de pruebas:

npm test

Construcción

Para compilar el código fuente de TypeScript en el directorio de distribución:

npm run build

Licencia

Este proyecto se proporciona tal cual para su integración con LM Studio y otros clientes MCP.