泰维欧管理器MCP

Name: 泰维欧管理器MCP
Author: errajibadr

作者：errajibadr2 星标更新：2025-11-17

安装使用来源：spider==github.com

项目介绍

Twilio Manager MCP

这是一个用于管理Twilio资源的Model Context Protocol (MCP)实现。该包提供了通过标准化的MCP接口来管理Twilio子账户、电话号码和监管捆绑包的工具。

功能

列出Twilio子账户
获取与子账户关联的电话号码
在子账户之间转移电话号码
获取监管捆绑包SID
支持直接通信和Server-Sent Events (SSE)通信
与Claude Desktop、Cursor和其他兼容MCP的工具集成

安装

预备条件

安装uv

在macOS上：

brew install uv

在Windows上：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

在Linux上：

curl -LsSf https://astral.sh/uv/install.sh | sh

项目设置

克隆仓库：

git clone https://github.com/yourusername/twilio_manager_mcp.git
cd twilio_manager_mcp

使用uv安装依赖项：

uv sync

配置

在根目录创建一个.env文件，并添加您的Twilio凭证：

TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token

通过创建.cursor/mcp.json文件配置您的工具（如Cursor、Claude Desktop等）的MCP：

{
  "mcpServers": { 
    "twilio_manager_mcp_abs": {
      "command": "uv",
      "args": ["--directory", "/path/to/twilio_manager_mcp", "run", "mcp", "run", "./twilio_manager_mcp.py"],
      "env": {
        "TWILIO_ACCOUNT_SID": "your_account_sid",
        "TWILIO_AUTH_TOKEN": "your_auth_token"
      }
    },
    "twilio_manager_mcp_uvx": {
      "command": "uvx",
      "args": [ "twilio-manager-mcp" ],
      "env": {
        "TWILIO_ACCOUNT_SID": "your_account_sid",
        "TWILIO_AUTH_TOKEN": "your_auth_token"
      }
    },
    "twilio_manager_mcp_sse": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Docker

您可以使用Docker运行Twilio Manager MCP以简化部署和管理。

使用Docker Compose

该项目包含一个Docker Compose配置，它设置了：

Twilio Manager MCP服务
带有自动HTTPS的Traefik反向代理

在您的.env文件中配置环境变量：

# Twilio凭证
TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token

# Traefik的域名配置
DOMAIN_NAME=yourdomain.com
ACME_EMAIL=user@yourdomain.com

# 地址详情（可选）
ADDRESS_CUSTOMER_NAME=
ADDRESS_FRIENDLY_NAME=
ADDRESS_STREET=
ADDRESS_CITY=
ADDRESS_REGION=
ADDRESS_POSTAL_CODE=
ADDRESS_ISO_COUNTRY=

启动服务：

docker-compose up -d

应用程序将在您配置的域上可用，并启用HTTPS。

不使用Docker Compose的Docker

如果您希望仅运行Twilio Manager MCP容器而不使用Traefik：

构建Docker镜像：

docker build -t twilio-manager-mcp .

运行容器：

docker run -p 8000:8000 \
  -e TWILIO_ACCOUNT_SID=your_account_sid \
  -e TWILIO_AUTH_TOKEN=your_auth_token \
  twilio-manager-mcp

SSE端点将在http://localhost:8000/sse可用。

使用方法

与Cursor、Claude Desktop或其他兼容MCP的工具一起使用

您有三种方式使用此MCP：

直接UVX集成（推荐）：
- 使用twilio_manager_mcp_uvx配置
- 这是最简单的方法，开箱即用支持uvx
直接UV集成：
- 使用twilio_manager_mcp_abs配置
- 需要指定安装的完整路径
SSE服务器：
- 使用twilio_manager_mcp_sse配置
- 首先启动SSE服务器：
```
uvicorn twilio_manager_mcp_sse:app --host 0.0.0.0 --port 8000
```

可用工具

工具名称	描述
`list_twilio_subaccounts`	列出所有Twilio子账户
`get_account_phone_numbers`	获取特定子账户的电话号码
`get_all_phone_numbers`	在子账户之间转移电话号码
`get_regulatory_bundle_sid`	获取子账户的监管捆绑包SID

在Cursor/Claude Desktop中的示例用法

一旦配置好，您可以在AI助手对话中直接使用这些工具：

列出所有子账户：

# AI会自动使用MCP列出所有子账户
# 不需要编写代码 - 只需询问“列出所有Twilio子账户”

获取子账户的电话号码：

# 简单询问：“显示子账户AC...的所有电话号码”

直接Python使用

对于直接编程使用：

from mcp import ClientSession
from clients.client import MCPClient

async with MCPClient("uvx", ["twilio-manager-mcp"], env={}) as session:
    # 列出可用工具
    tools = (await session.list_tools()).tools
    
    # 列出所有子账户
    subaccounts = await session.invoke("list_twilio_subaccounts")
    
    # 获取子账户的电话号码
    numbers = await session.invoke("get_account_phone_numbers", {"account_sid": "AC..."})

项目结构

twilio_manager_mcp/
├── api/
│   └── async_twilio_api.py    # 异步Twilio API实现
├── clients/
│   ├── client.py              # 直接MCP客户端实现
│   └── client_sse.py          # SSE客户端实现
├── twilio_manager_mcp.py      # 核心MCP服务器实现
├── twilio_manager_mcp_sse.py  # SSE服务器包装器
├── requirements.txt           # 项目依赖项
└── README.md                 # 此文件

开发

对于开发，您可以使用uv的虚拟环境管理：

# 创建虚拟环境
uv venv

# 激活虚拟环境
source .venv/bin/activate  # 在Unix上
.venv\Scripts\activate     # 在Windows上

# 在开发模式下安装依赖项
uv pip install -e .

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT许可证