phone-lookup

mcp-server-ktozvonil

ktozvonil.net 向けの MCP（Model Context Protocol）サーバーです。ウクライナを中心に利用されている、コミュニティによる電話番号の評判サービスです。AI アシスタントに 「050 110 89 01 から電話してきたのは誰ですか？」 と尋ねると、コミュニティの判定、スパム評価、通信事業者、地域、タグ、最近のレビューを回答します。

このパッケージは、サイトのネイティブ MCP エンドポイント（https://ktozvonil.net/mcp）へのシンプルな stdio ブリッジです。ツールは起動時に検出されるため、パッケージが古くなることはありません。

ツール

ツール	説明	認証
lookup_phone	電話番号に関するコミュニティの判定、評価、スパムレベル、通信事業者、地域、タグ、最近のレビュー	なし
post_comment	認証済みユーザーに代わってレビューを投稿します（AI エージェントが生成したレビューとして表示され、別枠で掲載されるため、コミュニティの評価には影響しません）	OAuth ベアラー

インストール

Claude Code

claude mcp add ktozvonil -- npx -y mcp-server-ktozvonil

Claude Desktop

{
  "mcpServers": {
    "ktozvonil": {
      "command": "npx",
      "args": ["-y", "mcp-server-ktozvonil"]
    }
  }
}

Cursor / Windsurf / その他の MCP クライアント

stdio MCP に対応しているクライアントなら、同じ方法で利用できます。コマンドは npx、引数は -y mcp-server-ktozvonil です。

リモート（インストール不要）

リモートサーバーに対応している MCP クライアントは、このパッケージを使わず、次のエンドポイントに直接接続できます。

https://ktozvonil.net/mcp

設定

環境変数	意味
KTOZVONIL_MCP_URL	エンドポイント URL を上書きします（デフォルトは https://ktozvonil.net/mcp）
KTOZVONIL_TOKEN	OAuth ベアラートークンです。post_comment の場合のみ必要です。検出先：/.well-known/oauth-protected-resource

例

ユーザー： +38 050 110 89 01 から電話してきたのは誰ですか？

アシスタント： （lookup_phone を呼び出します） この番号は ktozvonil.net でコミュニティから「スパム」と判定されています。78 件の報告があり、その大半は「しつこい広告」です……

開発

npm install
npm run build
npm test

関連項目

• ktozvonil.net — サービス本体（ウクライナ語／ロシア語／英語と、さらに 5 言語に対応）
• ua-phone — ウクライナの電話番号の解析／書式設定ライブラリ
• API ドキュメント：ktozvonil.net/.well-known/api-catalog

ライセンス

MIT © ktozvonil.net