MCP NIF.PT

Consulta y analiza empresas portuguesas utilizando la API pública de NIF.PT. Permite búsqueda por NIF, nombre de empresa y ciudad.

GitHub

Documentación

MCP NIF.PT

Este proyecto implementa un servidor inteligente basado en FastMCP, que permite consultar y analizar información sobre empresas portuguesas utilizando la API pública de NIF.PT. Soporta múltiples herramientas útiles como búsqueda por NIF, nombre de empresa o ciudad, verificación del estado de la empresa e identificación de negocios relacionados con la contabilidad.

Características

  • Obtener datos completos de la empresa por NIF
  • Verificar si una empresa está activa o cerrada
  • Identificar si una empresa está relacionada con la contabilidad
  • Buscar empresas por nombre y ciudad
  • Obtener el NIF basado en el nombre exacto de la empresa
  • Acceder a enlaces externos (Google Maps, Racius, Portugalio)

Estructura del Proyecto

.
├── main.py                   
├── models.py                
├── nif_client.py             
├── utils.py                
├── requirements.txt          
├── Dockerfile              
├── package.json             
└── .smithery.profile.json

Tecnologías Utilizadas

  • FastMCP
  • FastAPI
  • httpx
  • Pydantic
  • Docker
  • Python 3.10+

Cómo Ejecutar

Localmente

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python main.py

La aplicación utiliza transport="stdio" por defecto, lo que la hace compatible con Claude Desktop o entornos basados en terminal.

Ejemplos de Uso

  • ¿Cuál es la empresa con el NIF 504426744?
  • ¿La empresa con el NIF 504426744 está activa?
  • ¿La empresa con el NIF 504426744 es de contabilidad?
  • Buscar empresas con el nombre "contabilidade" en Lisboa
  • ¿Cuál es el NIF de la empresa "XPTO LDA"?

Formato de Salida

Las respuestas incluyen detalles como:

  • Nombre, ciudad, actividad y estado
  • Dirección con enlace a Google Maps
  • Contactos (teléfono, email, sitio web)
  • CAE (Código de Actividad Económica)
  • Enlaces externos (Racius, Portugalio)

Integración con Claude Desktop

Para integrar este MCP con Claude Desktop:

  1. Instalar Claude Desktop
    Descargar e instalar desde: https://claude.ai/download

  2. Abrir Configuración
    Ir a File > Settings > Developer y hacer clic en Editar Configuración

  3. Añadir la configuración del servidor MCP
    En claude_desktop_config.json, insertar la siguiente configuración:

{
  "mcpServers": {
    "nif-pt-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER",
        "run",
        "main.py"
      ]
    }
  }
}

Reemplazar /ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER con la ruta absoluta real donde se encuentra tu archivo main.py.

  1. Reiniciar Claude Desktop
    Después de guardar la configuración, reinicia Claude Desktop. Tu MCP nif-pt-server debería estar ahora disponible en la interfaz de Claude Desktop.

Instalación con un Solo Clic mediante Smithery

(https://smithery.ai/server/@ruicarvalho1/mcp_nif)

Con Claude Desktop abierto, puedes instalar este MCP directamente usando la CLI de Smithery.
Solo pega el siguiente comando en tu terminal:

npx -y @smithery/cli@latest install @ruicarvalho1/mcp_nif --client claude

Esto instalará automáticamente el MCP y lo registrará con Claude Desktop.

Autor

Desarrollado por Rui Carvalho.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.