PDF MCP Server

PDF MCP Server

Un servidor simple del Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de lectura de PDF utilizando pdfplumber.

Características

• extract_text: Extrae todo el contenido de texto de archivos PDF
• get_pdf_info: Obtiene información básica del PDF (número de páginas, metadatos, dimensiones)
• extract_tables: Extrae tablas de archivos PDF

Instalación

Opción 1: Sin instalación (usando uvx)

Puede ejecutar el servidor directamente sin instalarlo:

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

Opción 2: Instalación local

Clone el repositorio e instale las dependencias:

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

Uso

Si se instala localmente:

python main.py

El servidor se ejecuta mediante el transporte stdio y puede integrarse con cualquier cliente MCP.

Herramientas disponibles

extract_text

Extrae todo el contenido de texto de un archivo PDF.

Parámetros:

• file_path (string): Ruta al archivo PDF

Devuelve:

• Contenido de texto completo de todas las páginas

get_pdf_info

Obtiene información básica sobre un archivo PDF.

Parámetros:

• file_path (string): Ruta al archivo PDF

Devuelve:

• Diccionario que contiene:
  • page_count: Número de páginas
  • metadata: Metadatos del PDF (si están disponibles)
  • page_dimensions: Ancho y alto de la primera página

extract_tables

Extrae tablas de un archivo PDF.

Parámetros:

• file_path (string): Ruta al archivo PDF
• page_number (integer, opcional): Número de página específico para extraer (indexado desde 1)

Devuelve:

• Lista de tablas con:
  • page: Número de página donde se encontró la tabla
  • data: Datos de la tabla como una lista de filas (cada fila es una lista de valores de celda)

Integración con Claude Desktop

Para usar este servidor con Claude Desktop, agréguelo a su configuración de Claude Desktop:

Opción 1: Directamente desde GitHub (recomendado)

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

Opción 2: Desde instalación local

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

Requisitos

• Python 3.10+
• pdfplumber
• mcp