@addresspenny/mcp

用于 Addresspenny 地址验证的 Model Context Protocol 服务器。让 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 或更高版本

• 一个拥有 API 令牌及其账户 ID 的 Addresspenny 账户 — 请在 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

该服务器通过 stdio 使用 MCP 协议进行通信。它不打算直接调用 — 请使用上述配置将 MCP 客户端指向它。

许可证

MIT