AI导哈

AI通信服务器

spix-mcp是一个独立的Model Context Protocol服务器，为MCP兼容的AI客户端提供电话号码、邮箱和语音服务，适用于AI电话、邮件和短信通信。

  • by Spix-HQ
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Spix-HQ/spix-mcp

使用说明

spix mcp

Spix的MCP服务器——为任何兼容MCP的AI客户端提供电话号码、收件箱和语音。

spix-mcp 是一个独立的 模型上下文协议 该服务器将Spix的通信基础设施（电话、电子邮件、联系人、分析）作为MCP工具和资源公开。

将其连接到Claude Desktop、Cursor或任何兼容MCP的客户端，您的AI就可以接电话了。

安装

# via pip
pip install spix-mcp

# via uvx (no install needed)
uvx spix-mcp

还必须安装Spix CLI并进行身份验证：

curl -fsSL https://spix.sh/install.sh | sh
spix auth login

快速设置：克劳德桌面

最快的方法——使用Spix CLI中的内置安装程序：

spix mcp install claude

这会将正确的配置写入 ~/Library/Application Support/Claude/claude_desktop_config.json 自动。重新启动Claude Desktop，Spix工具立即出现。

或在中手动配置 claude_desktop_config.json:

{
  "mcpServers": {
    "spix": {
      "command": "uvx",
      "args": ["spix-mcp"],
      "env": {
        "SPIX_API_KEY": "spix_live_sk_your_key_here"
      }
    }
  }
}

从获取API密钥 app.spix.sh/设置/快捷键.

快速设置：光标

spix mcp install cursor

或者使用与上述相同的JSON结构手动添加到Cursor MCP配置中。

你的AI能做什么

连接后，您的AI客户端可以访问 43工具 （安全配置文件）或 49工具 （完整配置文件）涵盖所有Spix功能：

打电话

工具 说明
spix_call_create 拨打人工智能电话
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_thread 获取短信对话线程

战术

工具 说明
spix_playbook_create 创建通话或短信剧本
spix_playbook_list 列出所有剧本
spix_playbook_show 获取剧本详细信息
spix_playbook_update 更新剧本设置
spix_playbook_clone 克隆现有剧本
spix_playbook_pause 暂停剧本
spix_playbook_resume 恢复暂停的剧本
spix_playbook_delete 删除剧本 （完整简介）
spix_playbook_voice_list 列出可用声音
spix_playbook_language_list 列出支持的语言
spix_playbook_emotion_list 列出可用的情绪
spix_playbook_rule_add 将规则添加到剧本中
spix_playbook_rule_list 列出剧本规则
spix_playbook_rule_remove 删除剧本规则
spix_playbook_rule_clear 清除所有剧本规则

联系人

工具 说明
spix_contact_create 创建联系人
spix_contact_show 获取联系方式
spix_contact_list 列出联系人
spix_contact_history 获取与联系人的通信历史记录
spix_contact_summary 获取人工智能生成的联系人摘要
spix_contact_tag 为联系人添加标签

电话号码

工具 说明
spix_phone_list 列出您的电话号码
spix_phone_show 获取电话号码详细信息
spix_phone_bind 将数字绑定到剧本
spix_phone_unbind 删除绑定
spix_phone_release 释放电话号码 （完整简介）

Auth&API密钥

工具 说明
spix_auth_whoami 检查当前身份验证
spix_auth_key_list 列出API密钥
spix_auth_key_create 创建新的API密钥
spix_auth_key_revoke 吊销API密钥 （完整简介）

计费和分析

工具 说明
spix_billing_status 获取计费计划状态
spix_billing_credits 检查信用余额
spix_billing_credits_history 获取信用使用历史记录
spix_billing_plan_set 更改计费计划 （完整简介）

网络钩子

工具 说明
spix_webhook_endpoint_create 注册webhook端点
spix_webhook_endpoint_list 列出webhook端点
spix_webhook_subscription_create 订阅活动

资源（可读状态）

MCP服务器还公开实时可读资源：

resource://calls/{id}/transcript     — Call transcript
resource://calls/{id}/summary        — Call summary + extraction
resource://sms/{id}/thread           — SMS thread
resource://playbook/{id}             — Playbook details
resource://contact/{id}              — Contact details
resource://contact/{id}/history      — Contact history
resource://phone/{id}/route          — Phone number routing
resource://billing/credits           — Credit balance
resource://billing                   — Billing overview

工具轮廓

配置文件 工具 描述
safe （默认） 43 排除破坏性操作：密钥撤销、手机释放、剧本删除、呼叫取消、计划更改
full 49 所有工具，包括破坏性和计费操作

对于生产部署， safe 是推荐的。使用 full 仅适用于值得信赖的客户。

配置

所有配置都是通过环境变量进行的：

变量 必填 描述
SPIX_API_KEY 是 您的Spix API密钥
SPIX_DEFAULT_PLAYBOOK 否 呼叫的默认剧本ID
SPIX_SESSION_NAME 否 审核日志记录的会话名称
SPIX_TOOL_PROFILE 没有 safe （默认）或 full

范围访问示例

限制您的代理可以访问的内容：

{
  "mcpServers": {
    "spix": {
      "command": "uvx",
      "args": ["spix-mcp"],
      "env": {
        "SPIX_API_KEY": "spix_live_sk_your_key_here",
        "SPIX_DEFAULT_PLAYBOOK": "plb_call_abc123",
        "SPIX_SESSION_NAME": "sales-bot",
        "SPIX_TOOL_PROFILE": "safe"
      }
    }
  }
}

示例：让克劳德打个电话

配置后，您可以直接询问Claude（或任何连接的客户端）：

“使用潜在客户限定符剧本致电+19175550123，告诉我他们说了什么。”

克劳德将使用 spix_call_create，监视呼叫，然后呼叫 spix_call_summary 返回结果——无需编写任何代码。

运作原理

Your Agent (Claude, Cursor, etc.)
    ↓ MCP tool call
Spix MCP Server (this package)
    ↓ HTTP API call
Spix Backend (api.spix.sh)
    ↓ Carrier APIs
Phone call / Email / SMS

MCP服务器是MCP协议和Spix REST API之间的一个瘦桥。所有业务逻辑都在服务器端运行。

语音通话

当你的经纪人来电时 spix_call_createSpix：

  1. 通过Telnyx/Twilio拨打号码
  2. 用途 Deepgram Nova-3 用于实时语音识别
  3. 用途 克劳德 用于会话生成
  4. 用途 卡特西亚Sonic-3 用于文本转语音
  5. 记录通话并生成记录+摘要

然后，您的代理人可以通过以下方式阅读成绩单和摘要 spix_call_transcript 和 spix_call_summary.

与spix CLI的关系

spix-mcp 是独立的MCP服务器包。完整版 Spix命令行界面 包括内置的MCP服务器(spix mcp serve)以及所有其他Spix命令。

使用 spix-mcp 如果您只需要MCP服务器（例如，用于Claude Desktop集成而不安装完整的CLI）。如果您希望终端中的所有Spix命令都可用，请使用完整的CLI。

需求

  • Python 3.10+
  • Spix帐户（电子邮件免费沙盒；电话代理计划）
  • API密钥来自 app.spix.sh

链接

许可证

麻省理工学院——见 许可证

相关 MCP