Byteplant Mcp

Byteplant MCP サーバー

あらゆるMCPクライアントからメールアドレス、電話番号、郵便住所を検証できます。
世界240か国以上で、比類のない精度を実現します。

インストール · ツール · 認証情報 · 使い方 · 互換性 · リソース

---

これは、Claude、Cursor、VS Code などの AI アシスタントを Byteplant の検証 API に接続する MCP サーバーです。アシスタントにメールアドレス、電話番号、郵便住所の確認を依頼すると、対応する Byteplant ツールを呼び出し、結果を読み上げます。

サーバーはお使いのコンピューター上でローカルに動作し、stdio を介して MCP クライアントと通信します。

インストール

サーバーを実行する最も簡単な方法は、uvを使うことです。uvx はパッケージと適切なバージョンの Python を自動的にダウンロードするため、ほかにインストールするものはありません。

以下のいずれかの設定を使って MCP クライアントにサーバーを追加し、プレースホルダーをお使いのAPI キーに置き換えてください。使用するサービスのキーだけが必要です。

Claude Desktop

1. Claude Desktop で Settings → Developer → Edit Config に移動します。claude_desktop_config.json が開きます。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. Byteplant サーバーを追加します。

   {
     "mcpServers": {
       "byteplant": {
         "command": "uvx",
         "args": ["byteplant-mcp@latest"],
         "env": {
           "EV_TOKEN": "<EMAIL VALIDATOR API KEY>",
           "PV_TOKEN": "<PHONE VALIDATOR API KEY>",
           "AV_TOKEN": "<ADDRESS VALIDATOR API KEY>"
         }
       }
     }
   }
   

3. Claude Desktop を再起動します。

Claude Code

claude mcp add \
  --env EV_TOKEN=<EMAIL VALIDATOR API KEY> \
  --env PV_TOKEN=<PHONE VALIDATOR API KEY> \
  --env AV_TOKEN=<ADDRESS VALIDATOR API KEY> \
  --transport stdio byteplant -- uvx byteplant-mcp@latest

Cursor

Claude Desktopと同じ mcpServers エントリーを、~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に追加します。

VS Code

プロジェクトの .vscode/mcp.json にサーバーを追加します。

{
  "servers": {
    "byteplant": {
      "type": "stdio",
      "command": "uvx",
      "args": ["byteplant-mcp@latest"],
      "env": {
        "EV_TOKEN": "<EMAIL VALIDATOR API KEY>",
        "PV_TOKEN": "<PHONE VALIDATOR API KEY>",
        "AV_TOKEN": "<ADDRESS VALIDATOR API KEY>"
      }
    }
  }
}

uv の代わりに pip を使う

pip install byteplant-mcp

これにより byteplant-mcp コマンドがインストールされます。デスクトップアプリからはシェルの PATH が参照できないことが多いため、コマンドにはフルパスを使用してください（macOS/Linux では which byteplant-mcp、Windows では where byteplant-mcp で確認できます）。

"command": "/full/path/to/byteplant-mcp"

代わりに、インストール先の Python 環境でモジュールを実行することもできます。

"command": "/path/to/python",
"args": ["-m", "byteplant_mcp"]

ツール

ツール	機能
validate_email	メールアドレスに配信可能かどうかを確認し、フリーメールプロバイダーを検出します
validate_phone	電話番号を検証し、回線種別、通信事業者コード、所在地、形式を返します
validate_address	郵便住所を検証して標準化します。ジオコーディングも任意で利用できます

認証情報

各ツールはそれぞれ独自の API キーを使用し、環境変数としてサーバーに渡します。必要なサービスに登録してキーを取得してください。

環境変数	使用するツール	API キーの取得先
EV_TOKEN	validate_email	Email Validator
PV_TOKEN	validate_phone	Phone Validator
AV_TOKEN	validate_address	Address Validator

キーはByteplant アカウントで管理できます。キーが設定されていない場合、対応するツールは API を呼び出す代わりに、設定すべき環境変数をアシスタントに伝えます。

使用方法

たとえば、アシスタントに自然な言葉で質問するだけです。

• 「[email protected] は有効なメールアドレスですか？」
• 「+49 9874 322466 が携帯電話番号か固定電話番号か確認してください。」
• 「この住所を検証して、標準化された形式を教えてください：Heilsbronner Str. 4, 91564 Neuendettelsau, Germany。」

アシスタントが以下のツールパラメーターを入力します。各ツールには timeout パラメーターもあり、API の応答を待つ時間を設定します。5～300 秒で、デフォルトは 10 秒です。

validate_email - API ドキュメント

パラメーター	必須	説明
email	✅	検証するメールアドレス

出力

フィールド	説明
status	数値の結果コード。有効なアドレスの場合は 200 などです。結果コードの全一覧を参照してください。
category	サーバーによって追加されます。status に基づき、VALID、SUSPECT、INVALID、INDETERMINATE のいずれかになります（一覧にないコードの場合は UNKNOWN）。
status_description	サーバーによって追加されます。status コードの意味です。
info	簡潔なステータスの説明
details	ステータスの詳細な説明
freemail	メールアドレスがフリーメールプロバイダー（Gmail、Yahoo、Outlook/Hotmail/Live、AOL など）のものの場合は true

validate_phone - API ドキュメント

パラメーター	必須	説明
phone	✅	検証する電話番号。国内形式、または先頭に + を付けた国際形式で指定します。
code		2 文字の ISO 3166-1 国コード。電話番号が国際形式の場合は省略できます。
locale		ジオコーディング結果に使用する IETF 言語タグ。デフォルトは en-US です。
mode		extensive（デフォルト）は完全な検証を実行します。express は静的チェックのみを実行し、より高速です。

出力

フィールド	説明
status	VALID_CONFIRMED、VALID_UNCONFIRMED、INVALID、DELAYED、RATE_LIMIT_EXCEEDED、API_KEY_INVALID_OR_DEPLETED のいずれか
linetype	FIXED_LINE、MOBILE、VOIP、TOLL_FREE、PREMIUM_RATE、SHARED_COST、PERSONAL_NUMBER、PAGER、UAN、VOICEMAIL のいずれか
location	地理的な場所（市、郡、州）
countrycode	2 文字の ISO 3166-1 国コード
formatnational	電話番号の国内形式
formatinternational	電話番号の国際形式
mcc	モバイルネットワーク事業者（キャリア）を識別するモバイル国コード
mnc	モバイルネットワーク事業者（キャリア）を識別するモバイルネットワークコード

validate_address - API ドキュメント

パラメーター	必須	説明
code	✅	2 文字の ISO 3166-1 国コード。国際住所の場合は XX を使用します。
street_adr	✅	通り、番地、建物。部屋番号やアパート番号、または住所全体を含めることもできます。
street_num		street_adr に含まれていない場合の番地または建物番号
additional_info		建物、部屋、アパート、または階
city		市または地域
postal_code		ZIP コードまたは郵便番号
state		州または省
geocoding		住所の座標を返すかどうか。デフォルトではオフです。
locale		複数の郵便言語がある国で使用する出力言語。住所の翻訳にのみ使用し、住所の検証では空欄にしてください。
charset		utf-8（デフォルト）または us-ascii

出力

フィールド	説明
status	VALID：住所は正しく、配達可能です。SUSPECT：住所は配達可能にするための修正が必要で、修正案が提示されます。INVALID：住所は配達できず、自動修正もできません。その他の値：DELAYED、NO_COUNTRY、RATE_LIMIT_EXCEEDED、API_KEY_INVALID_OR_DEPLETED、RESTRICTED、INTERNAL_ERROR
formattedaddress	標準化された形式の完全な住所
supplement	住所の追加情報（建物、ユニット、アパート、スイート）
street	標準化された形式の通り
streetnumber	標準化された形式の番地
postalcode	標準化された形式の郵便番号
city	標準化された形式の市区町村
district	標準化された形式の地区
county	標準化された形式の郡
state	標準化された形式の州または県
country	ISO 3166-1 の2文字の国コード
type	住所の種類：S は住所、P は私書箱、受け取り場所、またはその他の配送サービスを示します
rdi	住宅配送指標：商業用または住宅用
diagnostics	住所入力のエラーに関するヒント。診断ヒントの全一覧を参照してください。
corrections	住所入力のどの部分が修正されたかを示すヒント。修正ヒントの全一覧を参照してください。
latitude, longitude	座標。geocoding が有効な場合に限り、有効な住所について返されます。

互換性

要件	バージョン
Python	3.10 以降（uvx により自動インストール）
MCP クライアント	Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、OpenAI Codex など、ローカルの stdio サーバーを実行できる任意のクライアント

ChatGPT と Claude のウェブ版またはモバイル版はリモート（ホスト型）MCP サーバーにしか接続できないため、現時点ではこのサーバーを使用できません。

リソース

• Model Context Protocol のドキュメント
• Email Validator API のドキュメント
• Phone Validator API のドキュメント
• Address Validator API のドキュメント
• Byteplant のウェブサイト
• お問い合わせ：[email protected]

ライセンス

MIT