Armavita Quo Mcp

armavita-quo-mcp

由 ArmaVita.com 倾情提供

需要定制实现？联系我们。

armavita-quo-mcp 是面向 Quo API 工作流（消息、通话、联系人、用户、电话号码和 Webhook）的本地优先 MCP 服务。

• MCP 传输：本地 stdio
• 运行环境：Node.js 18+
• 身份验证：QUO_API_KEY
• 许可证：AGPL-3.0-only

安装

npm install

运行

bash ./run.sh

run.sh 会检查 Node/npm，在需要时安装依赖，然后启动 MCP 服务。

必需的环境变量

• QUO_API_KEY：用于所有 API 调用的 Quo API 密钥。

可选：

• QUO_HTTP_TIMEOUT_MS：请求超时时间，单位为毫秒（默认值：30000）。

MCP 客户端快速配置

在 MCP 客户端配置中使用此模式：

{
  "mcpServers": {
    "armavita-quo-mcp": {
      "command": "bash",
      "args": ["/absolute/path/to/armavita-quo-mcp/run.sh"],
      "env": {
        "QUO_API_KEY": "YOUR_QUO_API_KEY"
      }
    }
  }
}

如果客户端从此文件夹启动，可以使用：

{
  "mcpServers": {
    "armavita-quo-mcp": {
      "command": "bash",
      "args": ["./run.sh"],
      "env": {
        "QUO_API_KEY": "YOUR_QUO_API_KEY"
      }
    }
  }
}

工具覆盖范围

• 消息：send_text、list_messages、get_message
• 对话：list_conversations
• 联系人：create_contact、list_contacts、get_contact、update_contact、delete_contact、get_contact_custom_fields
• 通话：list_calls、get_call、get_call_recordings、get_call_summary、get_call_transcription、get_voicemail
• 电话号码：list_phone_numbers、get_phone_number
• 用户：list_users、get_user
• Webhook：list_webhooks

分页

• 列表端点提供 Quo 分页参数，例如 maxResults 和 pageToken。
• 请保留并传递返回的页面令牌，以继续分页。

使用说明

• 在需要时使用 E.164 格式的电话号码（例如 +18325551234）。
• update_contact 至少需要一个要更新的字段。
• API 失败时会返回 Quo 状态和响应详情；服务端错误路径中的机密信息会被隐藏。

安全

• 切勿提交真实的 QUO_API_KEY 值。
• 请将凭据保存在客户端/服务端环境配置中，而非源文件中。
• 为开发、预发布和生产环境使用不同的密钥。

文档

• 身份验证
• 工具参考

范围

• 此仓库是一个开源本地 MCP 服务。
• 仅支持本地 stdio 传输模式。
• 有意不公开工具别名。

开发

语法检查：

npm run check

直接启动：

npm start

许可证

GNU Affero 通用公共许可证 v3.0（AGPLv3）。请参阅 LICENSE。