mcp-pt

[!IMPORTANTE] Este es un proyecto comunitario no oficial. No está afiliado a los proveedores de datos (DGEG, IPMA, INE, GeoAPI.pt, AMA/dados.gov.pt). Respeta los términos de cada proveedor — en particular, los datos de combustible de DGEG son para uso no comercial.

Lo que hace

Pregúntale a tu asistente de IA cosas como:

• "¿Cuál es la gasolinera de gasóleo más barata en el distrito de Lisboa?"

• "¿Lloverá mañana en Oporto? ¿Hay avisos meteorológicos activos?"

• "¿Qué localidad tiene el código postal 1990-096?"

• "¿Cuántos habitantes tenía Portugal en los Censos 2021?"

• "Busca conjuntos de datos sobre medio ambiente en dados.gov.pt."

…y llamará a la herramienta adecuada, consultará la API pública y responderá con datos reales.

Related MCP server: IPMA MCP Server

Instalación

Ejecútalo con npx (sin necesidad de instalación) — solo apunta tu anfitrión MCP hacia él.

Claude Desktop

Añade a claude_desktop_config.json (~/Library/Application Support/Claude/ en macOS, %APPDATA%\Claude\ en Windows):

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

Cursor

Añade a ~/.cursor/mcp.json (o al .cursor/mcp.json del proyecto):

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

Cualquier anfitrión MCP

El servidor habla MCP a través de stdio. Ejecuta npx -y mcp-pt (o node dist/index.js desde un clon) como comando del servidor.

Herramientas

Todas las herramientas llaman a APIs públicas y gratuitas y no necesitan claves API.

Ejemplo (MCP puro)

# List the tools over stdio
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"x","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | npx -y mcp-pt

Relación con los SDK

mcp-pt es la capa orientada a la IA sobre una familia de SDK independientes y multilingüe para los mismos datos — precos-combustiveis-pt, ipma-api, geoapi-pt-sdk, ine-pt y dados-gov-pt. El servidor es autónomo (llama a las APIs directamente), por lo que no tiene dependencia de esos paquetes.

Desarrollo

npm install
npm test        # vitest
npm run build   # tsup → dist/index.js (executable)
node dist/index.js

Preguntas frecuentes

No. Cada herramienta utiliza una API pública portuguesa gratuita.

No — es un proyecto comunitario independiente. Respeta los términos de cada proveedor (los datos de combustible de DGEG son de uso no comercial).

Cualquier cosa que hable MCP sobre stdio — Claude Desktop, Cursor, Continue y clientes personalizados que usen el SDK de MCP.

Licencia

MIT © Marcelo Domingues