@addresspenny/mcp

Model Context Protocol-Server für die Adressvalidierung mit Addresspenny. Ermöglicht es Claude Desktop, Cursor und jedem MCP-kompatiblen Agenten, Postanschriften zu validieren, Listen in großen Mengen zu bereinigen und Adressen aus freiem Text zu extrahieren.

Tools

• validate_address — validiert eine einzelne Postanschrift. Gibt die standardisierte Adresse und Validierungsmetadaten zurück. Verbraucht 1 Credit.

• bulk_validate — validiert bis zu 100 Adressen in einem Aufruf. Verbraucht 1 Credit pro Adresse.

• parse_and_validate — extrahiert jede Postanschrift aus unstrukturiertem Text (Chats, Transkripte, gescrapte Seiten) und validiert jede einzelne. Verbraucht 1 Credit pro extrahierter und validierter Adresse.

Related MCP server: Personal Toolkit MCP Server

Anforderungen

• Node.js 18 oder neuer

• Ein Addresspenny-Konto mit einem API-Token und der Konto-ID des Tokens — erstellen Sie beides unter addresspenny.com

Konfiguration

Der Server liest drei Umgebungsvariablen:

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder das Äquivalent auf Ihrem Betriebssystem:

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

Starten Sie Claude Desktop neu. Die Tools erscheinen unter dem Tool-Symbol in der Chateingabe.

Cursor

Fügen Sie dies zu ~/.cursor/mcp.json hinzu:

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

Lokale Entwicklung

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

Der Server spricht MCP über stdio. Er ist nicht dazu gedacht, direkt aufgerufen zu werden — verweisen Sie einen MCP-Client mithilfe der obigen Konfiguration darauf.

Lizenz

MIT