通信验证服务器

TeleSign MCP服务器是一个模型上下文协议(MCP)服务器,用于与TeleSign API无缝集成,支持发送短信、验证电话号码、评估欺诈风险等功能。

  • by mdp18
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mdp18/telesign-mcp

使用说明

电信号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帐户(在这里注册)

设置

  1. 克隆存储库:

    git clone https://github.com/mdp18/telesign-mcp.git
    cd telesign-mcp
    
  2. 安装依赖项:

    npm install
    
  3. 构建项目:

    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。