@addresspenny/mcp

Сервер Model Context Protocol для проверки адресов Addresspenny. Позволяет Claude Desktop, Cursor и любому MCP-совместимому агенту проверять почтовые адреса, массово очищать списки и извлекать адреса из произвольного текста.

Инструменты

• validate_address — проверка одного почтового адреса. Возвращает стандартизированный адрес и метаданные проверки. Потребляет 1 кредит.

• bulk_validate — проверка до 100 адресов за один вызов. Потребляет 1 кредит за каждый адрес.

• parse_and_validate — извлечение всех почтовых адресов из неструктурированного текста (чатов, транскриптов, спарсенных страниц) и проверка каждого из них. Потребляет 1 кредит за каждый извлеченный и проверенный адрес.

Related MCP server: Personal Toolkit MCP Server

Требования

• Node.js 18 или новее

• Учетная запись Addresspenny с API-токеном и ID учетной записи — создайте их на сайте addresspenny.com

Конфигурация

Сервер считывает три переменные окружения:

Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или эквивалентный файл в вашей ОС:

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

Перезапустите Claude Desktop. Инструменты появятся под значком инструментов в поле ввода чата.

Cursor

Добавьте в ~/.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"
      }
    }
  }
}

Локальная разработка

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

Сервер использует протокол MCP через stdio. Он не предназначен для прямого вызова — укажите на него MCP-клиенту, используя конфигурацию выше.

Лицензия

MIT