内容
spix-mcp
> Spix 的 MCP 服务器 — 为任何兼容 MCP 的 AI 客户端提供电话号码件箱和语音。
ix-mcp MCP 服务器](https://glama.ai/mcp/servers/Spix-HQ/spix-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Spix-HQ/spix-mcp)
[](https://pypi.org/project/spix-mcp/)
[](LICENSE)
[](https://docs.spix.sh/mcp)
`spix-mcp` 是一个独立的 [模型上下文协议](https://modelcontextprotocol.io) 服务器，暴露 Spix 的通信基础设施 — 电话、电子邮件、联系人、分析 — 作为 MCP 工具和资源。
将其连接到 Claude Desktop、Cursor 或任何兼容 MCP 的客户端，您的 AI 可以直接拨打电话。
---
## 安装
```bash
# 通过 pip
pip install spix-mcp
# 通过 uvx（无需安装）
uvx spix-mcp
```
还必须安装和验证 Spix CLI：
```bash
curl -fsSL https://spix.sh/install.sh | sh
sp login
```
---
## 快速设置：Claude Desktop
的方法 — 使用 Spix CLI 的内置安装程序：
```spix mcp install
```
这会自动将正确的配置写入 `~/Library/Application Support/Claude/claude_desktop_config.json`。重启 Claude Desktop，Spix 工具立即出现。
或手动在 `claude_desktop_config.json` 中配置：
```json
{
"mcpServers": {
"spix": {
"command": "uvx",
"args": ["spix-mcp"],
": {
"SPIX_API_KEY": "spix_live_sk_your_key_here }
}
}
}
```
从 [app.spix.sh-keys](https://app.spix.sh/settings/api-keys) 获取您的 API 密钥。
---
## 快速设置：Cursor
```bash
spix mcp install cursor
```
或使用上述相同的 JSON 结构手动添加到 Cursor MCP 配置中。
---
## 您的 AI的操作
连接后，您的 AI 客户端可以访问 **43 种工具**（安全配置文件）或 **49 种工具**（完整配置文件），涵盖所有 Spix 功能：
### 电话
工具 | 描述 |
|------|-------------|
| `spix_call_create` | 发起外呼 AI 电话 |
| `spix_call_show` | 获取通话状态和元数据 |
| `spix_call_list` | 列出最近的通话 |
| `spix_call_transcript` | 获取完整的通话记录 |
| `spix_call_summary` | 获取通话摘要 + 提取的字段 |
| `spix_call_cancel 取消进行中的通话 *(完整配置文件)* |
### 电子邮件
| | 描述 |
|------|-------------|
| `spix_email_send` | 从您的 Spix 收发送电子邮件 |
| `spix_email_reply` | 回复收到的电子邮件 |
| `spix_email_list`出收件箱中的 |
### 短信
工具 | 描述 |
|------|-------------|
| `spix_sms_send` | 发送短信消息 |
| `spix_sms_list` | 列出短信消息 |
| `spix_sms | 获取短信对话线程 |
剧本
| 工具 | 描述 |
|------|| `spix_playbook_create` | 创建通话或短信剧本 |
| `spix_playbook_list` | 列剧本 |
| `spix_playbook_show` | 获取剧本详情 |
| `spix_playbook_update` | 更新剧本设置 |
| `_playbook_clone` | 克隆现有剧本 |
|ix_playbook_pause`暂停剧本 |
|ix_playbook_resume 恢复暂停的剧本 `spix_playbook | 删除剧本 *(完整配置文件)* |
| `spix_playbook_voice_list`出可用语音 |
|ix_playbook_language_list` | 列出支持的语言 `spix_playbook_list` | 列出 |
| `spix_rule_add` | 向剧本添加规则 |
| `spix_playbook_rule_list`出剧本规则 |
spix_playbook_rule_remove` | 删除剧本规则 `spix_playbook` | 清除所有规则 |
### 联系| 工具 | 描述------|-------------|
| `spix_contact_create` | 创建 |
| `spix` | 获取联系人| `spix_contact | 列出联系人 `spix_contact_history 获取与联系人的通信历史 |
| `spix_contact_summary` | 获取 AI 生成的联系 |
| `spix_contact_tag` | 向联系标签 |
### 电话号码
| 工具 | 描述------|-------------|
| `_phone_list` | 列电话号码 |
| `spix_phone_show` | 获取电话号码详情 |
| `_phone_bind` | 将号码绑定到剧本 |
| `spix_phone_unbind` | |
| `sp_release` | 释放电话号码 *(完整配置文件)* |
### 身份验证和 API 密钥
| 工具 | 描述 |
|------|-------------|
| `spix_auth_whoami` | 检查当前身份验证 |
| `spix_auth_key_list` | 列出 API 密钥 |
| `spix_auth_key_create` | 创建新的 API 密钥 |
| `spix_auth_key_revoke` | 撤销 API 完整配置文件)* |
### 计费和分析
| 工具 | 描述 |
||
| `spix_b` | 获取计费计划状态 |
| `spilling_credits` |余额 |
| `spix_billing_credits_history`信用使用历史 |
|ix_billing_plan_set` | 更改计费完整配置文件)* |
### Webhook
| 工具 ||------|-------------|
| `spix_webhook_endpoint_create` | 注册 Webhook 端| `spix_webhook_endpoint_list` | 列出 端点 |
| `_webhook_subscription_create`订阅事件 |
---
## 资源（可读状态）
MCP 服务器还暴露了实时可读资源：resource://calls/{transcript — 通
resource://id}/summary — 通话摘要 + 提取://sms/{thread — 短信线程
resource://playbook/{id} — 剧本详情
resource://contact/{ — 联系人resource://contact/{id — 联系
resource://phone/{route — 电话号码路由
resource://billing/ — 信用余额
resource://billing — 计
```
---
##配置文件
| 配置文件工具 | 描述 |
||
| `（默认） | 排除破坏性操作撤销、电话号码剧本删除、通、计划更改 |
|` | 49 |，包括破坏性和计费操作 |
对于生产部署，建议使用`。仅在受信任的客户端上使用 `。
---
## 配置配置均通过环境变量
| 变量 | | 描述 |
|----------|| `SPIX` | 是 |ix API 密钥 `SPIX_DEFAULT` | 否 | 通剧本 ID |
SPIX_SESSION_NAME` | 否 | 审计日志名称 |
| `SPIX_TOOL_PROFILE` | 否 | `safe`（默认）或 `full` |
### 访问示例
限制代理的内容：
```json "mcpServers": {
"spix "command": "uvx",
"argsspix-mcp"],
"env": {
"SPIX": "spix_live_sk_your_key_here",
"SPIX_DEFAULT_PLAYBOOK": "plb_call_abc123",
"SPIX_SESSION_NAME": "sales-bot",
"SPIX_TOOL_PROFILE": "safe"
}
}
}
```
---
##要求 Claude 拨打配置完成后要求 Claude（连接的客户端）：
> “使用 prospect-qual剧本拨打 +19175550123，并告诉说了什么。”
Cl使用 `spix_call，监控通话 `spix_call_summary — 无需您编写任何代码。
---
##
```
您的代理（、Cursor 等）
工具调用
MCP 服务器（此）
↓ HTTP APISpix 后端（ix.sh）
运营商 API
电话 / 电子邮件 / 短信MCP 服务器是 MCP和 Spix REST API薄桥梁。所有都在服务器端运行。
### 语音通话
代理调用 `spix 时，Sp
1. 通过 Telnywilio 号码
2. 使用gram Nova-3实时语音识别
3 **Claude** 进行
4. 使用 **Cartesia Sonic-3**转语音
5通话并生成记录
您的代理spix_call_transcript `spix_call 读取记录和摘要。
与 spix CLI
`spix-mcp` 是独立的 MCP 服务器软件包。完整的 [Sphttps://github.comix-HQ/sp 包括内置的`spix serve`）以及所有ix 命令。
如果 MCP 服务器（例如，用于 集成，无需安装），请使用 `spix-mcp`。如果您希望在终端中使用所有，请使用完整的---
## 要求
3.10 Spix 账户（用于电子邮件计划用于通话）
自 [app.spix.sh](https://app.spix.sh) 的 API ---
## 链接
Spix — AI基础设施：** [.sh](https://.sh)
- **：** [app.sp](https://app.sh)
- **文档 服务器参考：** [docs.spix.sh/mcp://docs.spix)
- ** CLI — 终端中的电话、短信、电子邮件：** [Spix-HQ/spix-cli](https://github.com/Spix-HQ/spix-cli)
- **PyPI：** [pypi.org/project/spix-mcp](https://pypi.org/project/spix-mcp/)
- **配方 — 即用型代理工作流：** [sp/recipes](https://
