Começar & configurar o cliente¶

O mcp-portugal é um servidor Model Context Protocol. Expõe ferramentas por stdio que um cliente MCP (um assistente de IA) pode chamar. Não o corres diretamente no dia-a-dia — regista-lo no teu cliente.

Requisitos¶

Node.js 20 ou superior

Claude Desktop¶

Edita o claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "portugal": {
      "command": "npx",
      "args": ["-y", "mcp-portugal"]
    }
  }
}

Reinicia o Claude Desktop. As ferramentas aparecem no menu 🔌.

Claude Code¶

Adiciona um .mcp.json na raiz do projeto (ou usa claude mcp add):

{
  "mcpServers": {
    "portugal": { "command": "npx", "args": ["-y", "mcp-portugal"] }
  }
}

Cursor / outros clientes MCP¶

Qualquer cliente MCP que suporte servidores stdio funciona — aponta-o para npx -y mcp-portugal.

Experimentar sem cliente¶

Usa o MCP Inspector oficial:

npx @modelcontextprotocol/inspector npx -y mcp-portugal

Depois chama, por exemplo, list_holidays com { "year": 2026 }.

Correr a partir do código¶

git clone https://github.com/marcelogdomingues/mcp-portugal
cd mcp-portugal
npm install
npm start     # servidor stdio
npm test      # testes unitários + integração stdio

Exemplos de prompts¶

"O 123456789 é um NIF válido, e que tipo de contribuinte é?"
"Valida o IBAN PT50 0002 0123 1234 5678 9015 4."
"Lista os feriados nacionais portugueses de 2026."
"O dia 2026-04-25 é feriado em Portugal?"