Magpipe

magpipe-mcp-server

适用于 Magpipe 的 MCP 服务 — 可通过 Claude Code 和 Cursor 等 AI 编码工具管理 Agent、通话、短信、联系人和电话号码。

安装

npm install -g magpipe-mcp-server

也可以通过 npx 直接运行：

npx magpipe-mcp-server

设置

1. 获取 API 密钥

前往 magpipe.ai/settings → API 选项卡 → Generate New Key。

2. 配置 AI 工具

Claude Code

添加到 ~/.claude.json：

{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

环境变量

变量	必填	说明
MAGPIPE_API_KEY	是	以 mgp_ 开头的 API 密钥
MAGPIPE_API_URL	否	覆盖 API 基础 URL（默认值：https://api.magpipe.ai/functions/v1）

可用工具

Agent

• list_agents — 列出所有 Agent，可选筛选条件
• get_agent — 获取 Agent 的完整详情，包括分配的电话号码、自定义函数、知识来源和动态变量
• create_agent — 创建 Agent
• update_agent — 更新 Agent 配置
• delete_agent — 删除 Agent

通话

• list_calls — 列出通话记录，可按条件筛选
• get_call — 获取通话详情、转录文本和摘要
• initiate_call — 发起外呼
• terminate_call — 结束正在进行的通话
• get_recording — 获取签名录音 URL

消息

• list_messages — 列出短信
• get_message — 获取单条消息
• send_sms — 发送短信

电话号码

• list_phone_numbers — 列出已配置的号码
• search_phone_numbers — 搜索可购买的号码
• provision_phone_number — 购买号码
• release_phone_number — 释放号码

联系人

• list_contacts — 列出联系人，可搜索和筛选
• get_contact — 获取联系人详情
• create_contact — 创建联系人
• update_contact — 更新联系人
• delete_contact — 删除联系人

知识库

• list_knowledge_sources — 列出 Agent 的知识来源
• add_knowledge_source — 添加基于 URL 的知识
• add_knowledge_manual — 添加手动输入的文本知识
• delete_knowledge_source — 删除知识来源
• sync_knowledge_source — 重新抓取 URL 来源

语音

• list_voices — 列出可用语音
• delete_voice — 删除克隆的语音

日历

• get_calendar_slots — 获取可预约时段
• create_booking — 创建预约
• cancel_booking — 取消预约

API 密钥

• manage_api_keys — 生成、列出、撤销或更新 API 密钥

其他

• list_models — 列出可用的大模型
• chat_with_agent — 向 Agent 发送文本消息
• list_chat_sessions — 列出聊天会话
• list_custom_functions — 列出自定义函数
• create_custom_function — 创建自定义函数
• manage_dynamic_variables — 管理数据提取变量
• list_scheduled_actions — 列出计划操作

开发

cd packages/mcp-server
npm install
npm run build
MAGPIPE_API_KEY=mgp_xxx node dist/index.js

许可证

MIT