Structurize-MCP

Structurize-MCP

Structurize-MCP é um serviço baseado no Model Context Protocol que gera arquivos CSV estruturados a partir de descrições em linguagem natural. Ele usa o Google Gemini AI para analisar e gerar dados.

Funcionalidades

• Gera arquivos CSV a partir de descrições em linguagem natural
• Extrai automaticamente a estrutura de colunas e o conteúdo dos dados
• Gera nomes de arquivo descritivos
• Suporta delimitadores personalizados
• Possui método de análise local como fallback quando a chamada da API Gemini falha

Instalação

Instalação global via NPM

npm install -g structurize-mcp

Uso direto via npx

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

Instalação a partir do código-fonte

Clone o repositório e instale as dependências:

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

Como usar

Parâmetros de linha de comando

A ferramenta suporta os seguintes parâmetros de linha de comando:

• --gemini-api-key, -k: Google Gemini API Key (obrigatório)
• --csv-dir, -d: Diretório para salvar arquivos CSV (opcional, padrão: diretório csv no projeto)
• --help, -h: Exibe informações de ajuda

Exemplo de execução

# 通过 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

Integração com Claude Desktop

Para usar este servidor MCP no Claude Desktop, você precisa adicionar o seguinte ao arquivo de configuração do 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"
      ]
    }
  }
}

Se estiver executando a partir do código-fonte, você pode 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"
      ]
    }
  }
}

Certifique-se de substituir o seguinte:

• YOUR_GEMINI_API_KEY_HERE: Sua Google Gemini API Key
• /absolute/path/to/csv_output_directory: Caminho absoluto do diretório para salvar arquivos CSV

Após a configuração, reinicie o Claude Desktop e você poderá pedir ao Claude para gerar arquivos CSV.

Exemplo

# 使用自定义 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

Obtendo uma Google Gemini API Key

Para usar esta ferramenta, você precisa de uma Google Gemini API Key:

1. Acesse Google AI Studio
2. Faça login com sua conta Google
3. Vá para a página API Keys
4. Crie uma nova API Key

Armazenamento de arquivos CSV

• Por padrão, os arquivos CSV são armazenados na pasta csv na raiz do projeto
• Você pode especificar um caminho de armazenamento personalizado usando o parâmetro --csv-dir
• Os nomes dos arquivos gerados são baseados automaticamente no conteúdo do CSV (título, nomes de colunas e dados) e recebem um carimbo de data/hora para garantir exclusividade

Descrição das principais funcionalidades

• Gera automaticamente arquivos CSV a partir de descrições em linguagem natural
• Analisa inteligentemente a estrutura de colunas e o conteúdo dos dados
• Gera nomes de arquivo descritivos
• Suporta delimitadores personalizados

Contribuição

Issues e Pull Requests são bem-vindos.

Licença

MIT