Phone について
Phoneは電話番号の検証と解析を行うMCPサーバーです。基本的な番号チェックが必要なアプリやエージェント向けで、キー不要のオフライン動作と国際発信番号の検索に対応します。
主な機能
- 01オフラインでの番号検証と解析
- 02E.164形式への正規化
- 03国・地域の判定
- 04国内番号の桁数の妥当性確認
- 05国際発信番号の検索
活用シーン
- 01国際形式の番号の確認
- 02国コードを指定した国内番号の検証
- 03国の発信番号の検索
MCP 対応
MCPクライアントに `validate_phone` と `country_calling_codes` を提供します。stdioでローカル実行できるほか、共有メタツールを含むPipeworxリモートサーバー経由でも接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gateway.pipeworx.io/phone/mcpclaude mcp add --transport http pipeworx-io-phone https://gateway.pipeworx.io/phone/mcp{"mcpServers":{"pipeworx-io-phone":{"type":"http","url":"https://gateway.pipeworx.io/phone/mcp"}}}Cursor で開く{"servers":{"pipeworx-io-phone":{"type":"http","url":"https://gateway.pipeworx.io/phone/mcp"}}}VS Code で開く{"mcpServers":{"pipeworx-io-phone":{"type":"http","url":"https://gateway.pipeworx.io/phone/mcp"}}}{"mcpServers":{"pipeworx-io-phone":{"serverUrl":"https://gateway.pipeworx.io/phone/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
mcp-phone
電話番号を検証する MCP です。
Pipeworx の一部です。AI エージェントを 1679 以上の稼働中のデータソースに接続する MCP ゲートウェイです。
ツール
| ツール | 説明 |
|---|---|
validate_phone | E.164/ITU の国際電話番号計画に照らして電話番号を検証・解析します(キー不要、オフライン)。国を特定し、E.164 形式に正規化して、国内番号の桁数が妥当かどうかを確認します。国際電話番号(例:「+33 1 23 45 67 89」)または国番号(例:phone="020 7946 0958", country="GB")を指定してください。通信事業者や携帯電話か固定電話かは判定しません(その判定にはキーが必要な HLR 照会が必要です)。 |
country_calling_codes | 国際電話の発信番号を検索します。引数なしの場合はすべて表示します。query を指定すると、国名、ISO コード、発信番号で絞り込めます(例:「germany」、「DE」、「49」)。 |
クイックスタート
MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します:
{
"mcpServers": {
"phone": {
"url": "https://gateway.pipeworx.io/phone/mcp"
}
}
}
このエンドポイントが実際に提供するもの
https://gateway.pipeworx.io/phone/mcp の tools/list は、上の表のツールに加えて Pipeworx 共通のメタツール(ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で使える一連のツール)も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共通ツールが約 30 個表示されます。接続の initialize 応答には正確な対象範囲が示され、その日の状況を確認するための正式な情報となります。
これは意図的な仕様であり、誤って多重化しているわけではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できるため、2 つ目の MCP サーバーを追加する必要がありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。
または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
どちらの URL も、同じゲートウェイと同じ 1679 以上のデータソースに接続します。異なるのは、どのパックのツールが 直接 一覧表示されるかだけです。どちらからでも、ask_pipeworx ですべてのツールを利用できます。
MCP クライアントがない場合:HTTP で呼び出す
curl -X POST https://gateway.pipeworx.io/v1/tools/validate_phone \
-H 'Content-Type: application/json' \
-d '{"phone":"+33 1 23 45 67 89"}'
最初の呼び出しにはアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/validate_phone を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。
スタンドアロン(ゲートウェイアカウント不要)
このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です:
{
"mcpServers": {
"phone": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-phone"]
}
}
}
または、直接実行して起動を確認します:
npx -y @pipeworx/mcp-phone
stdin/stdout 経由で MCP をやり取りし、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。
ask_pipeworx の使用
ツールを直接呼び出す代わりに、平易な英語で質問できます。この機能は、上記のパックエンドポイントでもフルゲートウェイでも使えます:
ask_pipeworx({ question: "your question about Phone data" })
ゲートウェイが適切なツールを選び、引数を自動的に入力します。
詳細情報
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。