电信号MCP服务器
一个模型上下文协议（MCP）服务器，为Anthropic的Claude、OpenAI的ChatGPT或谷歌的Gemini等人工智能助手提供与TeleSign API的无缝集成。使您的AI能够发送短信、验证电话号码、评估欺诈风险等。
什么是MCP？
这 模型上下文协议 是一个开放标准，允许人工智能助手安全地连接到外部数据源和工具。该服务器实现了MCP，使AI助手可以直接访问TeleSign的通信和验证API。
🔨 特性
可用工具
| 工具 | 说明 |
|---|---|
verifyapi_send_otp | 通过短信、语音、WhatsApp、Viber、RCS或电子邮件发送一次性密码，并支持自动回退 |
verifyapi_check_code | 验证用户输入的OTP代码 |
verifyapi_get_status | 检查正在进行的验证的状态 |
phoneid_get_info | 获取电话号码详细信息，包括类型（移动电话/固定电话/VoIP）、运营商和位置 |
intelligence_assess_risk | 通过允许/标记/阻止建议获得欺诈风险评分（0-1000） |
messaging_send_sms | 发送短信（OTP、警报或营销） |
docs_search | 搜索TeleSign文档 |
docs_get | 检索主题的完整文档 |
核心能力
- 多通道OTP验证 -通过短信、语音、WhatsApp、Viber、RCS或电子邮件发送验证码，并在通道之间自动回退
- 手机智能 -识别电话号码类型、运营商和地理位置
- 防止欺诈 -实时风险评分，检测欺诈电话号码
- 短信服务 -发送交易或营销信息
- 内置文档 -通过人工智能助手直接访问TeleSign API文档
🛠️ 安装
先决条件
- Node.js 18+
- Cursor、Claude Code、VSCode、Windsurf或其他MCP客户端
- 具有API证书的TeleSign帐户(在这里注册)
设置
- 克隆存储库：
git clone https://github.com/mdp18/telesign-mcp.git
cd telesign-mcp- 安装依赖项：
npm install- 构建项目：
npm run build配置
环境变量
设置您的TeleSign API凭据：
export TELESIGN_CUSTOMER_ID="your-customer-id"
export TELESIGN_API_KEY="your-api-key"Claude桌面配置
将此添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"telesign": {
"command": "node",
"args": ["/path/to/telesign-mcp/build/index.js"],
"env": {
"TELESIGN_CUSTOMER_ID": "your-customer-id",
"TELESIGN_API_KEY": "your-api-key"
}
}
}
}用法示例
配置后，您可以要求Claude：
- _“30秒后通过短信发送OTP至+15551234567，语音回退”_
- _“验证参考ID abc-123的代码123456”_
- _“获取有关电话号码+15551234567的信息”_
- _“检查+15551234567的欺诈风险评分”_
- _“发送短信至+15551234567，告知'您的订单已发货'”_
📚 API文档
服务器包括可通过以下方式访问的内置文档 docs_search 和 docs_get 工具。可用主题：
verify-api-OTP验证端点和流程phone-id-电话号码查询详细信息intelligence-风险评分和欺诈检测messaging-sms-短信指南status-codes-API响应代码参考
🤝 支持的API
目前功能正常
- \[x\] 验证API -支持回退的多通道OTP验证（短信、语音、WhatsApp、Viber、RCS、电子邮件）
- \[x\] 电话ID API -带有身份属性插件的电话号码智能（SIM卡交换、号码停用、联系信息、移植历史等）
- \[x\] 智能API -欺诈风险评分和建议
- \[x\] 消息 API -基本短信发送(
/v1/messaging)
即将推出
- \[\]批量短信API
- \[\]消息API（全功能）
- \[\]SMS验证API（独立）
- \[\]无声验证API
- \[\]模板API
- \[\]Voice V2 API语音V2
- \[\]账户API
- \[\]应用程序验证API
- \[\]Flow Builder API
💻 发展
# Watch mode for development
npm run dev
# Build for production
npm run build
# Run the server directly
npm start📄 许可证
Apache 2.0-请参阅 许可证 了解详情。
🛟 支持
⚠️ 免责声明
这是一个社区驱动的开源项目 与TeleSign没有正式关联、没有TeleSign的认可或支持。作者不拥有或主张TeleSign商标、名称或品牌的任何权利。“TeleSign”和任何相关徽标都是TeleSign Corporation的商标。
本项目按“原样”提供，不提供任何形式的保修。使用风险自负。对于与此MCP服务器无关的官方TeleSign支持，请直接联系TeleSign。