phone carrier detector

電話キャリア検出 MCP サーバー

中国の携帯電話番号の通信事業者と帰属地域を検出する MCP（Model Context Protocol）サーバーです。

機能

• 🔍 通信事業者の検出: 中国の主要3大通信事業者（中国移動、中国聯通、中国電信）の番号識別に対応
• 📍 帰属地域の検出: 省および市レベルの帰属地域情報を提供
• 📱 仮想通信事業者: 仮想通信事業者の番号識別に対応
• 🚀 一括処理: 複数の携帯電話番号の一括検出に対応（最大100件）
• 📊 詳細情報: 通信事業者、帰属地域、プレフィックスなどの詳細情報を提供
• 🎯 高精度: 実際の中国通信事業者の番号帯データベース（492,088件）に基づいています
• ⚡ 高性能: インメモリデータベースにより、非常に高速に検索できます

対応する通信事業者

通信事業者	主な番号帯
中国移動	134-139, 147, 150-152, 157-159, 172, 178, 182-184, 187-188, 198
中国聯通	130-132, 145, 155-156, 166, 175-176, 185-186
中国電信	133, 149, 153, 173, 177, 180-181, 189, 199
中国広電	192
中国鉄通	174

インストール

方法1: ソースからインストール

git clone https://github.com/dahuangbaojian/sms-mcp-server.git
cd sms-mcp-server

方法2: そのまま使用

このプロジェクトは Python 標準ライブラリを使用しているため、追加の依存関係は不要です。テストを実行する場合は、次のコマンドを使用します。

pip install pytest

使用方法

MCP クライアントで使用する

1. MCP クライアント（Claude Desktop など）を設定します。

{
  "mcpServers": {
    "phone-carrier-detector": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {}
    }
  }
}

2. クライアントを再起動すると、次のツールを使用できます。

単一番号の検出

请帮我检测手机号码 13812345678 的运营商和归属地信息

番号の一括検出

请帮我批量检测这些号码的运营商和归属地：13812345678, 18687654321, 13312345678

API ツール

1. detect_carrier

単一の携帯電話番号の通信事業者と帰属地域情報を検出します。

パラメーター:

• phone_number (string): 検出する携帯電話番号（11桁）

出力例:

{
  "success": true,
  "phone_number": "13812345678",
  "carrier": "China Mobile",
  "carrier_cn": "移动",
  "province": "江苏",
  "city": "连云港",
  "prefix": "1381234"
}

2. batch_detect_carriers

複数の携帯電話番号の通信事業者と帰属地域情報を一括検出します。

パラメーター:

• phone_numbers (array): 検出する携帯電話番号のリスト（最大100件）

出力例:

{
  "success": true,
  "total": 3,
  "results": [
    {
      "success": true,
      "phone_number": "13812345678",
      "carrier": "China Mobile",
      "province": "江苏",
      "city": "连云港"
    }
  ]
}

データソース

このプロジェクトでは、実際の中国携帯電話番号の帰属地域データベースを使用しており、以下が含まれています。

• 492,088 件のレコード
• 主要な通信事業者をすべて網羅
• 市レベルまでの精度
• リアルタイムで更新

開発

テストの実行

# 运行所有测试
python tests/run_tests.py --all

# 运行单元测试
python tests/run_tests.py --unit

# 运行集成测试
python tests/run_tests.py --integration

# 运行数据解析器测试
python tests/run_tests.py --data

データの解析

# 从原始数据文件生成数据库
python parse_phone_data.py

ローカルテスト

python mcp_server.py

プロジェクト構成

.
├── mcp_server.py              # MCP协议主服务
├── parse_phone_data.py        # 数据解析脚本
├── data/                      # 数据目录
│   ├── 手机号归属地1219.txt   # 原始数据文件
│   └── phone_database.json    # 解析后的数据库
├── tests/                     # 测试目录
│   ├── test_mcp_server.py     # 单元测试
│   ├── test_mcp_integration.py # 集成测试
│   ├── test_data_parser.py    # 数据解析测试
│   └── run_tests.py           # 测试运行器
├── package.json               # MCP配置
├── mcp-metadata.json          # MCP元数据
└── README.md                  # 项目说明

技術スタック

• Python 3.8+
• MCP Protocol 2024-11-05
• JSON-RPC 2.0
• 正規表現 - 番号形式の検証
• インメモリデータベース - 高速な検索

パフォーマンスの特徴

• メモリ使用量: ~100MB（49万件のレコードを含む）
• 検索速度: O(1) のハッシュテーブル検索
• 並行処理のサポート: 非同期処理により、高い並行性に対応
• エラー処理: 充実したエラー処理とパラメーター検証

コントリビューション

Issue や Pull Request の投稿を歓迎します！

1. プロジェクトを Fork します
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュします (git push origin feature/AmazingFeature)
5. Pull Request を開きます

ライセンス

このプロジェクトは MIT ライセンスを採用しています。詳細は LICENSE ファイルをご覧ください。

更新履歴

v1.0.0

• 初回リリース
• 中国の主要3大通信事業者の検出に対応
• 帰属地域（省＋市）の検出に対応
• 仮想通信事業者の検出に対応
• 番号の一括検出に対応
• 実際のデータベースに基づく（49万件以上のレコード）
• MCP プロトコルを完全に実装
• 包括的なテストカバレッジ

サポート

問題や提案がある場合は、次の方法をご利用ください。

1. Issuesを確認する
2. 新しい Issue を作成する
3. [email protected] にメールを送信する

---

⭐ このプロジェクトが役に立った場合は、スターを付けてください！