@addresspenny/mcp

Servidor del Protocolo de Contexto de Modelo (MCP) para la validación de direcciones de Addresspenny. Permite a Claude Desktop, Cursor y cualquier agente compatible con MCP validar direcciones postales, limpiar listas de forma masiva y extraer direcciones de texto de formato libre.

Herramientas

• validate_address — valida una única dirección postal. Devuelve la dirección normalizada y los metadatos de validación. Consume 1 crédito.

• bulk_validate — valida hasta 100 direcciones en una sola llamada. Consume 1 crédito por dirección.

• parse_and_validate — extrae todas las direcciones postales de texto no estructurado (chats, transcripciones, páginas web extraídas) y valida cada una de ellas. Consume 1 crédito por dirección extraída y validada.

Related MCP server: Personal Toolkit MCP Server

Requisitos

• Node.js 18 o superior

• Una cuenta de Addresspenny con un token de API y el ID de cuenta del token — créelos ambos en addresspenny.com

Configuración

El servidor lee tres variables de entorno:

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en su sistema operativo:

{
  "mcpServers": {
    "addresspenny": {
      "command": "npx",
      "args": ["-y", "@addresspenny/mcp"],
      "env": {
        "ADDRESSPENNY_API_KEY": "your-api-token",
        "ADDRESSPENNY_ACCOUNT_ID": "acct_your_account_id"
      }
    }
  }
}

Reinicie Claude Desktop. Las herramientas aparecerán bajo el icono de herramientas en la entrada de chat.

Cursor

Añada a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "addresspenny": {
      "command": "npx",
      "args": ["-y", "@addresspenny/mcp"],
      "env": {
        "ADDRESSPENNY_API_KEY": "your-api-token",
        "ADDRESSPENNY_ACCOUNT_ID": "acct_your_account_id"
      }
    }
  }
}

Desarrollo local

npm install
npm run build
ADDRESSPENNY_API_KEY=... ADDRESSPENNY_ACCOUNT_ID=... node build/index.js

El servidor utiliza MCP a través de stdio. No está diseñado para ser invocado directamente; apunte un cliente MCP hacia él utilizando la configuración anterior.

Licencia

MIT