Crixin Voice

crixin

面向 AI Agent 的 MCP 工具包。 一个 npm 包中包含两个 MCP，共用一个本地 SQLite，并安装到你已经在使用的、支持 MCP 的主机中。

• Voice MCP — 为你的 AI 接入一条电话线路。通过你自己的 Twilio 拨打真实的外呼电话、发送 SMS 并进行转录。
• Coder MCP — 为你的 AI 提供记忆。读取你所有 Claude Code、Codex CLI 和 Cursor 会话的历史记录。

本地优先。自备 Twilio。自备大模型。中间没有 SaaS。

安装

npm i -g crixin
crixin install                # writes BOTH MCPs (voice + coder) into Claude Desktop, Claude Code, Cursor, Codex CLI

如果只想使用其中一部分，也可以选择：

crixin voice install          # only the phone half
crixin coder install          # only the memory half

对于 Voice MCP，请在 AI 主机启动时使用的环境中设置 Twilio 凭据：

export TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export TWILIO_AUTH_TOKEN=your_auth_token
export TWILIO_PHONE_NUMBER=+15555550100
export DEEPGRAM_API_KEY=...   # optional — needed for Voice Wrapped + Caller Archetype

平台模式（无需 Twilio 账号）

不想自备 Twilio？从 Crixin 控制面板获取 API 密钥并进行设置即可——六个语音工具都会通过 Crixin 托管平台路由：

CRIXIN_API_KEY=crx_live_... npx -y crixin voice mcp

无需 TWILIO_* 变量，也无需 DEEPGRAM_API_KEY（转录在服务端运行）。如有需要，可通过 CRIXIN_API_BASE 覆盖 API 来源。地理区域限制仍在本地执行——严格要求同意的目的地（美国／英国／欧盟／澳大利亚）无论如何都必须设置 consented: true。

拨号前先验证：

crixin voice doctor           # BYO: one GET against Twilio. Platform mode: checks your key + minute quota. No charges.

对于 Coder MCP，请导入你的 AI 编码历史记录：

crixin coder ingest           # pulls Claude Code, Codex CLI, Cursor sessions → ~/.crixin/crixin.db

远程 MCP（无需安装）

托管平台通过 Streamable HTTP 提供相同的六个语音工具。将任意 MCP 主机指向此端点，并使用你的 crx_live_… 密钥：

claude mcp add --transport http crixin-voice https://crixin-platform.vercel.app/api/mcp \
  --header "Authorization: Bearer crx_live_..."

Cursor / VS Code：添加 HTTP MCP 服务，并使用相同的 URL 和 Authorization 标头。ChatGPT：设置 → 连接器 → 开发者模式 → 添加 URL。该端点为无状态（仅支持 POST）；工具名称、参数和结果与本地服务完全相同。

每个 MCP 提供的功能

Voice MCP — crixin-voice

工具	功能
make_call	拨打外呼电话。使用 to + prompt（助手会朗读提示词；记录接听者的回复），或使用原始 TwiML。
get_call	查看单个 Call SID 的状态／时长／价格／时间戳。
list_calls	查看近期通话——可按 to / from / status / start_time_after 筛选。
list_recordings	获取 Call SID 对应的录音和受身份验证保护的媒体 URL。
transcribe_call	使用 Deepgram 转录录音。支持 30 多种语言，包括阿拉伯语。
send_sms	通过 Twilio 发送 SMS / MMS。支持 Messaging Service。

Coder MCP — crixin-coder

工具	功能
search_sessions	对导入的所有 Claude Code / Codex / Cursor 会话进行全文搜索。
list_recent_sessions	按时间从新到旧列出会话，并显示项目和 token 数量。
get_session	按 ID 获取完整的会话记录。
stats	统计本地 SQLite 存储中的汇总数量。

日常命令

# Voice MCP
crixin voice doctor                # live-probe Twilio (no charges)
crixin voice call <to> [prompt]    # one-off call from the CLI
crixin voice sms  <to> <body>      # one-off SMS
crixin voice ingest                # pull recent Twilio calls + Deepgram transcripts → local SQLite
crixin voice wrapped --year 2026   # annual recap (HTML) — heatmaps, archetype, top destinations
crixin voice archetype             # caller archetype reveal (Quick Pitcher / Patient Listener / …)
crixin voice mcp                   # run as a stdio MCP server (used by AI hosts via npx)

# Coder MCP
crixin coder ingest                # ingest AI coding sessions → ~/.crixin/crixin.db
crixin coder search <query>        # CLI search across sessions
crixin coder dashboard             # local Hono dashboard on 127.0.0.1
crixin coder wrapped --year 2026   # annual recap (HTML) — top projects, monthly bars, archetype
crixin coder archetype             # 11 archetypes — 5 for you, 6 for your AI
crixin coder mcp                   # run as a stdio MCP server (used by AI hosts via npx)

# Sync (Pro) — one account, every machine, same session list
crixin sync status                 # device + link state + queue counts (works on Free)
crixin sync link                   # opens browser to approve this device
crixin sync push                   # send metadata to the server (manual, foreground)
crixin sync pull                   # fetch peer metadata into the local inbox
crixin sync inbox                  # latest pulled records from your other machines

仅元数据。 Sync v1 会在你的各台设备之间共享会话索引，但不会共享消息正文、会话记录、凭据、电话号码或自由文本标签。你的代码绝不会离开本地磁盘。

按主机手动安装

# Claude Code
claude mcp add crixin-voice -- npx -y crixin voice mcp
claude mcp add crixin-coder -- npx -y crixin coder mcp

# Cursor — append to ~/.cursor/mcp.json
{
  "mcpServers": {
    "crixin-voice": { "command": "npx", "args": ["-y","crixin","voice","mcp"] },
    "crixin-coder": { "command": "npx", "args": ["-y","crixin","coder","mcp"] }
  }
}

# Codex CLI — append to ~/.codex/config.toml
[mcp_servers.crixin-voice]
command = "npx"
args = ["-y","crixin","voice","mcp"]

[mcp_servers.crixin-coder]
command = "npx"
args = ["-y","crixin","coder","mcp"]

也可以直接运行 crixin install，由它自动完成配置。

Wrapped（年终报告）

两个部分都会生成独立的 HTML 报告。

crixin voice wrapped               # → ./crixin-voice-wrapped-2026.html
crixin coder wrapped               # → ./crixin-coder-wrapped-2026.html

一天中各时段的热力图、月度柱状图、类型揭秘（耐心倾听者／强势促成者／躲避者／牛仔／架构师／……）、热门目的地或热门项目、热门语言或热门模型。已去除个人身份信息。可截图分享。无需上传。

技术栈

• STT：Deepgram Nova-2（可选 — DEEPGRAM_API_KEY）。
• TTS：通过 TwiML <Say> 使用 Twilio Polly 和 Google 神经语音。（en-US 使用 Polly.Joanna-Neural，ar-EG 使用 Polly.Hala-Neural，es-ES 使用 Polly.Lucia-Neural 等。）
• LLM：开源通话路径中不使用 LLM — 由你的 AI 主机决定说什么。Pro 套餐可接入托管版 Wrapped 和记忆同步。
• 存储：本地 SQLite，路径为 ~/.crixin/crixin.db。数据表：voice_calls、voice_recordings、sessions、messages。

定价

套餐	价格	包含内容
开源版	永久免费	两个 MCP、所有工具、所有 Wrapped 和所有原型。采用 MIT 许可证。自备 Twilio。
Crixin Unlimited	$9.99/mo	无需 Twilio 账户即可托管通话：通话次数不限，每月固定收费。每月前 60 分钟使用高级语音，之后使用标准语音，再之后使用基础语音 — 通话始终可以接通。每个账户一次只能进行一通电话。平台模式（CRIXIN_API_KEY）和远程 MCP 均包含在此套餐中。

现有的 Coder Pro（$5/mo：托管版 Wrapped + crixin sync）将继续运行，并将并入 Unlimited。

查看完整定价。

隐私保护

• 你与 Twilio 之间没有任何服务器。通话会携带你的身份验证标头，直接发送至 api.twilio.com。
• Coder MCP 会读取 AI 主机已写入你磁盘的 JSONL 文件。数据不会离开你的设备。

隐私政策

完整政策：https://crixin.com/legal/privacy（生效日期：2026 年 6 月 17 日）。简而言之：

• **本地模式（自备 Twilio）：**此软件包不会收集任何数据。通话会携带你的凭据，直接发送至 Twilio；通话记录和转录内容保存在你设备上的 ~/.crixin/crixin.db 中。你的 AI 主机会像查看其他工具一样查看工具结果。
• **托管模式（CRIXIN_API_KEY 或远程 MCP）：**Crixin 平台会存储通话元数据（号码、时间戳、时长、状态）、你请求的录音和转录内容，以及用于计费的用量计数器。通话由 Twilio 承载；转录由 Deepgram 执行；托管语音通话使用 OpenAI、Deepgram 和 ElevenLabs 模型。我们不会出售数据。
• **保留期限：**账户处于活动状态期间保留账户数据；账户删除后 30 天内删除；录音和转录内容随账户一并删除；支付记录按法律要求保留。
• **联系：**[email protected]（隐私请求） · [email protected]（支持）。
• 转录内容和通话录音保存在你的 Twilio 账户和本地 SQLite 中。
• 无遥测数据。无上传。无分析像素。

地理限制（Voice MCP）

向严格要求征得同意的司法管辖区（US、Canada、UK、IE、FR、ES、IT、NL、AU、NZ）拨打外呼电话，必须显式使用 --consented 标志，或在 MCP 工具参数中设置 consented: true。宽松司法管辖区（Egypt、UAE、KSA、Jordan、Kuwait、Qatar、Bahrain、Oman、Lebanon、Nigeria、ZA）无需该标志即可拨号。德国则完全禁止拨打。可通过 CRIXIN_VOICE_ALLOWED_CC 覆盖此设置。

文档

安装 · Voice MCP · Coder MCP · Wrapped · Archetype · 定价 · 常见问题

许可证

MIT。由 @Mrdopplereffekt 构建。