Twilio Messaging MCP 服务器

一个 MCP (模型上下文协议) 服务器，可以通过 Twilio API 发送 SMS 消息。

功能

• 通过 Twilio 发送 SMS 消息
• 与 Claude Desktop 等 MCP 客户端集成
• 安全的凭据处理，无需环境变量
• 使用 Twilio API 密钥以提高安全性

安装

您可以直接通过 npx 使用此服务器：

npx twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

或者全局安装它：

npm install -g twilio-messaging-mcp-server
twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

配置

服务器需要以下参数：

• accountSid: 您的 Twilio Account SID (必须以 'AC' 开头，将会被验证)
• apiKey: 您的 Twilio API Key (以 'SK' 开头)
• apiSecret: 您的 Twilio API Secret
• number: 用于发送消息的 Twilio 电话号码 (采用 E.164 格式，例如，+1234567890)

安全提示

此服务器使用 API 密钥和 Secret 而不是 Auth Tokens，以提高安全性。 这种方法提供了更好的访问控制，并且能够在需要时撤销凭据。 有关更多信息，请参阅 Twilio API 密钥文档。

与 Claude Desktop 一起使用

本地开发

对于本地开发（当软件包未发布到 npm 时），将以下内容添加到您的 Claude Desktop 配置文件中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "/PATHTONODE/twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

用您实际的 Twilio 凭据替换这些值：

• 第一个参数：您的 Twilio Account SID (以 "AC" 开头)
• 第二个参数：您的 Twilio API Key (以 "SK" 开头)
• 第三个参数：您的 Twilio API Secret
• 第四个参数：您的 Twilio 电话号码，采用 E.164 格式

您可以通过在项目目录中运行以下命令来获取绝对路径：

# On macOS/Linux
echo "$(pwd)/build/index.js"

# On Windows (PowerShell)
Write-Output "$((Get-Location).Path)\build\index.js"

发布到 npm 后

将软件包发布到 npm 后，您可以使用以下配置：

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "npx",
      "args": [
        "-y", 
        "twilio-messaging-mcp-server",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

可用工具

send-sms

通过 Twilio 发送 SMS 消息。

参数：

• to: 目标电话号码，采用 E.164 格式 (例如，+1234567890)
• message: 要发送的消息内容

在 Claude 中的使用示例：

Can you send an SMS to +1234567890 saying "Hello from MCP!"

开发

要构建项目：

npm install
npm run build

手动运行服务器

要手动启动服务器进行测试（在 Claude Desktop 之外）：

# 使用实际凭据运行
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret" "+1234567890"

# 或者使用 npm 脚本（它使用 ts-node 进行开发）
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret" "+1234567890"

服务器将启动并等待 MCP 客户端连接。 您应该看到如下输出：

[TwilioMessagingServer] Server started successfully

与 Claude Desktop 一起使用时，Claude 加载配置文件时会自动启动服务器。 您无需手动启动它。

许可证

MIT