warp

warp-mcp

适用于 Ringer WARP platform 的 MCP 服务——涵盖 SIP 中继、电话号码、号码携转、消息/10DLC、计费和 CDR 分析。

让 AI Agent（Claude、Cursor、Copilot、Codex、ChatGPT）能够全面访问 WARP Customer API：提供 135 个工具，涵盖中继配置、号码搜索与订购、号码携入全生命周期、10DLC 品牌/营销活动注册、短信发送、发票和通话明细分析。

快速开始

# Recommended: global install — the setup wizard runs automatically
npm install -g warp-mcp

# Or run the wizard explicitly / without installing
npx -y warp-mcp setup

向导会验证你的 API 密钥，将其保存到 ~/.warp-mcp/config.json，并将服务注册到检测到的所有 MCP 客户端（Claude Code、Claude Desktop、Cursor、Codex、GitHub Copilot、ChatGPT Desktop）。

你需要一个 WARP API 密钥（rk_...）——前往 WARP portal 的 Settings → API Keys 创建。

一键安装

Claude Code

claude mcp add -s user warp -e WARP_API_TOKEN=rk_your_key -- npx -y warp-mcp

Cursor — 点击安装（然后替换 YOUR_WARP_API_KEY）

手动安装（适用于任何 MCP 客户端）

{
  "mcpServers": {
    "warp": {
      "command": "npx",
      "args": ["-y", "warp-mcp"],
      "env": { "WARP_API_TOKEN": "rk_your_key" }
    }
  }
}

请参阅 INSTALL.md，了解各客户端的安装步骤、故障排除方法和卸载步骤。

托管端点

无需本地安装——直接连接到 https://mcp.warp.ringer.tel/（Streamable HTTP）。

桌面连接器（claude.ai、ChatGPT）： 使用该 URL 添加自定义连接器，并在提示时 使用你的 WARP 账户登录——托管端点通过 OAuth 2.1 进行身份验证，并授予你的客户级权限（不包括管理界面、Buzz 和 API 密钥管理——这些仍需在门户中操作）。

开发者 / 命令行客户端： 改用 bearer rk_ 密钥进行身份验证：

claude mcp add --transport http warp https://mcp.warp.ringer.tel/ \
  --header "Authorization: Bearer $WARP_API_KEY"

{
  "mcpServers": {
    "warp": {
      "type": "http",
      "url": "https://mcp.warp.ringer.tel/",
      "headers": { "Authorization": "Bearer rk_your_key_here" }
    }
  }
}

前往 WARP portal 的 Settings → API Keys 创建密钥。

工具

前缀	分组	工具数	功能
trunk_	SIP 中继	24	中继 CRUD、SIP 凭据、端点、IP ACL、注册
port_	号码携转	33	端到端处理号码携入请求：草稿 → 验证 → 提交 → 激活、文档、TIN 合规
msg_	消息	33	发送短信、消息历史记录、10DLC 品牌/营销活动、号码注册、TCR 参考数据
num_	号码	15	搜索、订购、释放 DID；按 TN 设置语音/短信配置；携出 PIN
team_	团队	9	成员和 RBAC 角色
bill_	计费	5	余额、账本、发票（JSON + HTML）
cdr_	分析	5	通话明细记录、统计数据、趋势、CSV 导出
acct_ / net_ / key_	账户	10	容量、使用率、作用域、WARP 网络 IP、API 密钥审计
warp_status	诊断	1	配置和连接检查

该服务还内置了 warp-guide 提示词（以及服务说明），包含深入的 WARP 领域知识——工作流、概念和常见错误。

环境变量

变量	默认值	用途
WARP_API_TOKEN	—	API 密钥（rk_...）。覆盖 ~/.warp-mcp/config.json 中的设置
WARP_API_BASE_URL	https://api.warp.ringer.tel	API 基础 URL 覆盖值
WARP_REQUEST_TIMEOUT_MS	30000	单次请求超时时间

令牌解析顺序：环境变量 → ~/.warp-mcp/config.json → 未经身份验证（工具会提示你运行设置）。

开发

npm ci --ignore-scripts
npm run build   # tsc → dist/
npm test        # vitest (in-memory MCP transport)
npm run dev     # tsx src/index.ts

发布由 CI 完成：运行 npm version patch|minor|major，使用 --follow-tags 推送，然后创建 GitHub release——工作流会将软件包发布到 npm（使用 OIDC 可信发布并提供来源证明），并发布到 MCP Registry（io.github.ringer/warp）。首次发布后，请勿在本地运行 npm publish。

许可证

MIT © Ringer