MCP NIF.PT

Consulte e analise empresas portuguesas usando a API pública do NIF.PT. Suporta pesquisa por NIF, nome da empresa e cidade.

GitHub

Documentação

MCP NIF.PT

Este projeto implementa um servidor inteligente baseado em FastMCP, permitindo consultar e analisar informações sobre empresas portuguesas utilizando a API pública do NIF.PT. Ele suporta diversas ferramentas úteis, como pesquisa por NIF, nome da empresa ou cidade, verificação do estado da empresa e identificação de negócios relacionados à contabilidade.

Funcionalidades

  • Obter dados completos da empresa por NIF
  • Verificar se uma empresa está ativa ou encerrada
  • Identificar se uma empresa está relacionada à contabilidade
  • Pesquisar empresas por nome e cidade
  • Obter o NIF com base no nome exato da empresa
  • Acessar links externos (Google Maps, Racius, Portugalio)

Estrutura do Projeto

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

Tecnologias Utilizadas

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

Como Executar

Localmente

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

A aplicação utiliza transport="stdio" por padrão, tornando-a compatível com o Claude Desktop ou ambientes baseados em terminal.

Exemplos de Uso

  • Qual é a empresa com o NIF 504426744?
  • A empresa com o NIF 504426744 está ativa?
  • A empresa com o NIF 504426744 é de contabilidade?
  • Procurar empresas com o nome "contabilidade" em Lisboa
  • Qual é o NIF da empresa "XPTO LDA"?

Formato de Saída

As respostas incluem detalhes como:

  • Nome, cidade, atividade e estado
  • Morada com link para o Google Maps
  • Contactos (telefone, email, website)
  • CAE (Código de Atividade Económica)
  • Ligações externas (Racius, Portugalio)

Integração com o Claude Desktop

Para integrar este MCP com o Claude Desktop:

  1. Instalar o Claude Desktop
    Baixe e instale a partir de: https://claude.ai/download

  2. Abrir a Configuração
    Vá para File > Settings > Developer e clique em Editar Configuração

  3. Adicionar a configuração do servidor MCP
    No claude_desktop_config.json, insira a seguinte configuração:

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

Substitua /ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER pelo caminho absoluto real onde o seu arquivo main.py está localizado.

  1. Reiniciar o Claude Desktop
    Após salvar a configuração, reinicie o Claude Desktop. O seu MCP nif-pt-server agora deve estar disponível na interface do Claude Desktop.

Instalação com Um Clique via Smithery

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

Com o Claude Desktop aberto, você pode instalar este MCP diretamente usando a CLI do Smithery.
Basta colar o seguinte comando no seu terminal:

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

Isso instalará automaticamente o MCP e o registrará no Claude Desktop.

Autor

Desenvolvido por Rui Carvalho.

Licença

Este projeto está licenciado sob a Licença MIT.