Phone Carrier Detector

Detects Chinese mobile phone carriers, including China Mobile, China Unicom, China Telecom, and virtual operators.

一个用于检测中国手机号码运营商和归属地的 MCP (Model Context Protocol) 服务器。

- 🔍运营商检测: 支持中国三大运营商（中国移动、中国联通、中国电信）的号码识别
- 📍归属地检测: 提供省份和城市级别的归属地信息
- 📱虚拟运营商: 支持虚拟运营商号码识别
- 🚀批量处理: 支持批量检测多个手机号码（最多100个）
- 📊详细信息: 提供运营商、归属地、前缀等详细信息
- 🎯高精度: 基于真实的中国运营商号码段数据库（492,088条记录）
- ⚡高性能: 内存数据库，查询速度极快

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

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

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

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

- phone_numbers(array): 要检测的手机号码列表（最多100个）

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

# 运行所有测试 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

. ├── 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) 哈希表查找
- 并发支持: 异步处理，支持高并发
- 错误处理: 完善的错误处理和参数验证
- Fork 项目
- 创建功能分支 (git checkout -b feature/AmazingFeature)
- 提交更改 (git commit -m 'Add some AmazingFeature')
- 推送到分支 (git push origin feature/AmazingFeature)
- 打开 Pull Request

- 初始版本发布
- 支持中国三大运营商检测
- 支持归属地检测（省份+城市）
- 支持虚拟运营商检测
- 支持批量号码检测
- 基于真实数据库（49万+记录）
- 完整的 MCP 协议实现
- 全面的测试覆盖
- 查看Issues
- 创建新的 Issue
- 发送邮件到huangjian@ztinfo.cn

Manage your WhatsApp, SMS and Phone Calls using a single MCP connector