PDF MCP Server

PDF MCP Server

Um servidor simples de Model Context Protocol (MCP) que fornece recursos de leitura de PDF usando pdfplumber.

Recursos

• extract_text: Extrai todo o conteúdo de texto de arquivos PDF
• get_pdf_info: Obtém informações básicas do PDF (número de páginas, metadados, dimensões)
• extract_tables: Extrai tabelas de arquivos PDF

Instalação

Opção 1: Sem instalação (usando uvx)

Você pode executar o servidor diretamente sem instalá-lo:

uvx --from git+https://github.com/gstiebler/pdf-mcp-server.git pdf-mcp-server

Opção 2: Instalação local

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

git clone https://github.com/gstiebler/pdf-mcp-server.git
cd pdf-mcp-server
uv sync

Uso

Se instalado localmente:

python main.py

O servidor executa usando transporte stdio e pode ser integrado a qualquer cliente MCP.

Ferramentas Disponíveis

extract_text

Extrai todo o conteúdo de texto de um arquivo PDF.

Parâmetros:

• file_path (string): Caminho para o arquivo PDF

Retorna:

• Conteúdo de texto completo de todas as páginas

get_pdf_info

Obtém informações básicas sobre um arquivo PDF.

Parâmetros:

• file_path (string): Caminho para o arquivo PDF

Retorna:

• Dicionário contendo:
  • page_count: Número de páginas
  • metadata: Metadados do PDF (se disponíveis)
  • page_dimensions: Largura e altura da primeira página

extract_tables

Extrai tabelas de um arquivo PDF.

Parâmetros:

• file_path (string): Caminho para o arquivo PDF
• page_number (inteiro, opcional): Número da página específica para extrair (baseado em 1)

Retorna:

• Lista de tabelas com:
  • page: Número da página onde a tabela foi encontrada
  • data: Dados da tabela como uma lista de linhas (cada linha é uma lista de valores de células)

Integração com Claude Desktop

Para usar este servidor com o Claude Desktop, adicione-o à sua configuração do Claude Desktop:

Opção 1: Direto do GitHub (recomendado)

{
  "mcpServers": {
    "pdf-reader": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gstiebler/pdf-mcp-server.git", "pdf-mcp-server"]
    }
  }
}

Opção 2: Da instalação local

{
  "mcpServers": {
    "pdf-reader": {
      "command": "python",
      "args": ["/path/to/pdf-mcp-server/main.py"]
    }
  }
}

Requisitos

• Python 3.10+
• pdfplumber
• mcp