MCP-PDF2MD

MCP-PDF2MD

Serviço MCP-PDF2MD

Um serviço de conversão de PDF para Markdown de alto desempenho baseado em MCP, alimentado pela API de OCR do Mistral AI, com suporte a processamento em lote para arquivos locais e links de URL com saída estruturada.

Principais Recursos

• Conversão de Formato: Converte arquivos PDF para o formato Markdown estruturado.
• Suporte a Múltiplas Fontes: Processa tanto arquivos PDF locais quanto URLs de PDF remotos.
• Integração MCP: Integra-se perfeitamente com clientes de LLM como o Claude Desktop.
• Preservação de Estrutura: Visa manter a estrutura original do documento, incluindo títulos, parágrafos e listas.
• Extração de Imagens: Extrai automaticamente imagens do PDF e as salva localmente.
• Extração de Alta Qualidade: Utiliza o OCR de última geração do Mistral AI para extração de texto e informações de layout de alta qualidade.

Requisitos do Sistema

• Python 3.10+
• uv para gerenciamento de ambiente e pacotes (recomendado)

Início Rápido

1. Clone o repositório e entre no diretório:

   git clone https://github.com/zicez/mcp-pdf2md.git
   cd mcp-pdf2md
   

2. Instale as dependências com uv:

   uv sync
   

3. Configure as variáveis de ambiente:

   Crie um arquivo .env no diretório raiz do projeto e defina sua chave de API do Mistral AI:

   MISTRAL_API_KEY=your_mistral_api_key_here
   

4. Inicie o serviço:

   uv run pdf2md
   

Argumentos de Linha de Comando

O servidor suporta os seguintes argumentos de linha de comando:

• --output-dir: Especifica o diretório para salvar os arquivos Markdown convertidos e as imagens. O padrão é ./downloads.

Exemplo:

uv run pdf2md --output-dir /path/to/my/output

Configuração do Claude Desktop

Adicione a seguinte configuração no Claude Desktop:

Windows:

{
  "mcpServers": {
    "pdf2md": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\mcp-pdf2md",
        "run",
        "pdf2md",
        "--output-dir",
        "C:\\path\\to\\output"
      ],
      "env": {
        "MISTRAL_API_KEY": "your_mistral_api_key_here"
      }
    }
  }
}

Linux/macOS:

{
  "mcpServers": {
    "pdf2md": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-pdf2md",
        "run",
        "pdf2md",
        "--output-dir",
        "/path/to/output"
      ],
      "env": {
        "MISTRAL_API_KEY": "your_mistral_api_key_here"
      }
    }
  }
}

Nota sobre a Configuração da Chave de API: Você pode definir a chave de API de duas maneiras:

1. No arquivo .env dentro do diretório do projeto (recomendado para desenvolvimento).
2. Na configuração do Claude Desktop, conforme mostrado acima (recomendado para uso regular).

Se você definir a chave de API em ambos os locais, a da configuração do Claude Desktop terá precedência.

Ferramentas MCP

O servidor fornece as seguintes ferramentas MCP:

• convert_pdf_url(url: str): Converte um PDF de uma URL para Markdown. Suporta URLs únicas ou múltiplas URLs separadas por espaços, vírgulas ou quebras de linha.
• convert_pdf_file(file_path: str): Converte um arquivo PDF local para Markdown. Suporta caminhos de arquivo únicos ou múltiplos separados por espaços, vírgulas ou quebras de linha.

Obtendo uma Chave de API do Mistral AI

Este projeto depende da API do Mistral AI para extração de conteúdo de PDF. Para obter uma chave de API:

1. Visite a Plataforma Mistral AI e crie uma conta.
2. Navegue até a seção "API Keys" no seu espaço de trabalho.
3. Crie uma nova chave secreta.
4. Copie a chave de API gerada.
5. Use esta chave como valor para MISTRAL_API_KEY.

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Créditos

Este projeto utiliza a API de OCR do Mistral AI.