mcpField
B
botcall-mcp

botcall-mcp

本地服务
github.com/danecodes通信协作030 周前更新
代码仓库

关于 botcall-mcp

botcall-mcp 为 AI Agent 提供接收短信和提取验证码的电话号码。其工具涵盖号码申请、收件箱访问、号码管理和用量查询。

主要功能

  1. 01申请电话号码
  2. 02提取短信验证码
  3. 03获取近期短信
  4. 04列出和释放号码
  5. 05查看套餐与用量

适用场景

  1. 01接收注册验证短信
  2. 02查看已申请号码的来信
  3. 03验证后释放号码
  4. 04检查账户用量和限额

MCP 相关

它以工具形式向 MCP 兼容客户端提供电话号码和短信操作，包括 Claude Desktop 和 Claude Code。服务使用 MCP stdio 传输，并需要 botcall.io API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "danecodes-botcall": {
      "command": "npx",
      "args": [
        "-y",
        "botcall-mcp"
      ],
      "env": {
        "BOTCALL_API_KEY": "<BOTCALL_API_KEY>"
      }
    }
  }
}
启动命令npx -y botcall-mcp
需要配置的环境变量
BOTCALL_API_KEY密钥Your botcall API key from botcall.io

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmbotcall-mcp0.1.2

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
countrystring否ISO 国家/地区代码（默认值：US）
areaCodestring否首选区号（例如，西雅图的 '206'）。可选。

详细介绍

botcall-mcp

一个为 AI Agent 提供真实电话号码的 MCP 服务。申请号码、接收 SMS 并提取验证码，全都通过工具调用完成。

适用于 Claude Desktop、Claude Code 以及任何兼容 MCP 的客户端。

设置

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "botcall": {
      "command": "npx",
      "args": ["-y", "botcall-mcp"],
      "env": {
        "BOTCALL_API_KEY": "bs_live_..."
      }
    }
  }
}
Claude Code
claude mcp add botcall -- npx -y botcall-mcp

然后在环境中设置 API 密钥：

export BOTCALL_API_KEY="bs_live_..."
其他 MCP 客户端

任何支持 MCP stdio 传输 的客户端都可以使用。设置 BOTCALL_API_KEY 后运行 npx botcall-mcp。

获取 API 密钥

在 botcall.io 注册，选择套餐，然后从 Dashboard → API Keys 获取密钥。

工具

provision_number

申请一个新的电话号码，用于接收 SMS。

参数类型描述
areaCodestring首选区号，例如 "206"（可选）
countrystringISO 国家代码（默认值："US"）
get_code

等待收到 SMS 并提取验证码。持续长轮询，直到收到消息或超时。

参数类型描述
timeoutnumber等待秒数（默认值：30，最大值：30）
numberIdstring筛选指定号码（可选）
get_inbox

获取号码收到的近期 SMS 消息。

参数类型描述
limitnumber返回的最大消息数（默认值：10）
numberIdstring筛选指定号码（可选）
list_numbers

列出所有已申请的电话号码。无需参数。

release_number

释放不再需要的电话号码。

参数类型描述
numberIdstring必填。 要释放的号码 ID
get_usage

获取当前套餐、限额和使用情况统计。无需参数。

示例

You: Sign up for ExampleService using a phone number

Agent: I'll provision a number and handle the verification.

→ provision_number({ areaCode: "415" })
  { number: "+14155550123", id: "pn_abc123" }

→ [agent enters the number on ExampleService's signup page]

→ get_code({ numberId: "pn_abc123" })
  Verification code: 847291

→ [agent enters 847291 to complete verification]

环境变量

变量描述
BOTCALL_API_KEY必填。 你的 botcall.io API 密钥
BOTCALL_API_URLAPI 基础 URL（默认值：https://api.botcall.io）

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。