Structurize-MCP

Structurize-MCP

Structurize-MCP es un servicio basado en el Model Context Protocol que genera archivos CSV estructurados a partir de descripciones en lenguaje natural. Utiliza Google Gemini AI para analizar y generar datos.

Características

• Genera archivos CSV a partir de descripciones en lenguaje natural
• Extrae automáticamente la estructura de columnas y el contenido de los datos
• Genera nombres de archivo descriptivos
• Soporta separadores personalizados
• Método de análisis local como respaldo cuando falla la llamada a la API de Gemini

Instalación

Instalación global con NPM

npm install -g structurize-mcp

Uso directo mediante npx

npx structurize-mcp --gemini-api-key YOUR_GEMINI_API_KEY

Instalación desde el código fuente

Clone el repositorio e instale las dependencias:

git clone https://github.com/your-username/structurize-mcp.git
cd structurize-mcp
npm install
npm run build

Uso

Parámetros de línea de comandos

La herramienta admite los siguientes parámetros de línea de comandos:

• --gemini-api-key, -k: Clave de API de Google Gemini (obligatoria)
• --csv-dir, -d: Directorio para guardar archivos CSV (opcional, por defecto es el directorio csv del proyecto)
• --help, -h: Muestra información de ayuda

Ejemplo de ejecución

# 通过 npx 运行
npx structurize-mcp --gemini-api-key YOUR_GEMINI_API_KEY --csv-dir /path/to/save/csv

# 如果全局安装过
structurize-mcp --gemini-api-key YOUR_GEMINI_API_KEY --csv-dir /path/to/save/csv

# 从源码目录运行
node ./bin/structurize.js --gemini-api-key YOUR_GEMINI_API_KEY --csv-dir /path/to/save/csv

Integración con Claude Desktop

Para usar este servidor MCP en Claude Desktop, debe agregar lo siguiente al archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "csv-generator": {
      "command": "npx",
      "args": [
        "structurize-mcp",
        "--gemini-api-key",
        "YOUR_GEMINI_API_KEY_HERE",
        "--csv-dir",
        "/absolute/path/to/csv_output_directory"
      ]
    }
  }
}

Si se ejecuta desde el código fuente, puede usar:

{
  "mcpServers": {
    "csv-generator": {
      "command": "node",
      "args": [
        "/absolute/path/to/structurize-mcp/build/index.js",
        "--gemini-api-key",
        "YOUR_GEMINI_API_KEY_HERE",
        "--csv-dir",
        "/absolute/path/to/csv_output_directory"
      ]
    }
  }
}

Asegúrese de reemplazar lo siguiente:

• YOUR_GEMINI_API_KEY_HERE: Su clave de API de Google Gemini
• /absolute/path/to/csv_output_directory: La ruta absoluta del directorio para guardar archivos CSV

Una vez completada la configuración, reinicie Claude Desktop y luego podrá pedirle a Claude que genere archivos CSV.

Ejemplo

# 使用自定义 API Key 和保存目录
npx structurize-mcp --gemini-api-key YOUR_GEMINI_API_KEY --csv-dir ~/Documents/csv_files

# 只自定义 API Key，使用默认保存目录
npx structurize-mcp --gemini-api-key YOUR_GEMINI_API_KEY

# 只自定义保存目录（但需要确保 API Key 以其他方式提供）
npx structurize-mcp --csv-dir /data/csv_exports

Obtener una clave de API de Google Gemini

Para usar esta herramienta, necesita una clave de API de Google Gemini:

1. Visite Google AI Studio
2. Inicie sesión con su cuenta de Google
3. Vaya a la página de API Keys
4. Cree una nueva clave de API

Almacenamiento de archivos CSV

• De forma predeterminada, los archivos CSV se almacenan en la carpeta csv en la raíz del proyecto
• Puede especificar una ruta de almacenamiento personalizada mediante el parámetro --csv-dir
• Los nombres de archivo generados se crean automáticamente según el contenido del CSV (título, nombres de columnas y datos) y se les agrega una marca de tiempo para garantizar su unicidad

Descripción de las funciones principales

• Genera automáticamente archivos CSV a partir de descripciones en lenguaje natural
• Analiza de forma inteligente la estructura de columnas y el contenido de los datos
• Genera nombres de archivo descriptivos
• Soporta separadores personalizados

Contribuciones

Se aceptan Issues y Pull Requests.

Licencia

MIT