Sipgate API MCP Server

Sipgate API MCP Server

site icon
2025.04.23 0
JavaScript通信服务API集成交流协作
Sipgate API MCP Server 是一个非官方的集成服务,通过提供对 sipgate API 的访问,使AI助手能够与 sipgate 服务进行交互,包括短信、通话和账户管理等功能。
View on GitHub

Overview

基本能力

产品定位

Sipgate API MCP Server 是一个中间件服务,旨在通过MCP协议为AI助手提供与 sipgate 通信服务的集成能力。

核心功能

  • 账户管理:获取账户信息和用户信息。
  • 通信功能:发送短信和发起电话呼叫。
  • 电话系统管理:获取电话号码列表、设备列表和通话历史记录。

适用场景

  • 自动化短信发送
  • 自动化电话呼叫
  • 账户和通信服务管理

工具列表

  • Account Management
  • get_account_info: 获取 sipgate 账户信息
  • get_user_info: 获取认证用户信息
  • Communication
  • send_sms: 发送短信
  • initiate_call: 发起电话呼叫
  • Phone System
  • get_phone_numbers: 列出关联的电话号码
  • get_devices: 列出关联的设备
  • get_call_history: 访问通话历史记录

常见问题解答

  1. 认证错误
  2. 确认 Token ID 和 Token 是否正确
  3. 检查令牌是否具有所需权限
  4. 安装问题
  5. 确保已安装 Node.js
  6. 尝试在安装前运行 npx clear-npx-cache
  7. 服务器连接问题
  8. 检查互联网连接
  9. 确认 MCP 设置中已启用服务器

使用教程

使用依赖

  1. 需要一个 sipgate 账户(https://www.sipgate.de/)
  2. 从 sipgate 获取个人访问令牌凭证:
  3. 登录 sipgate 账户
  4. 导航到 "Settings" > "Personal Access Tokens"
  5. 创建新令牌
  6. 记下 Token ID 和 Token

安装教程

Claude

添加到 claude_desktop_config.json 文件:

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

VS Code

使用以下命令安装:

# For VS Code
code --add-mcp '{"name":"sipgate-api","command":"npx","args":["-y","sipgateio-mcp"],"env":{"SIPGATE_TOKEN_ID":"your-token-id","SIPGATE_TOKEN":"your-token"}}'

# For VS Code Insiders
code-insiders --add-mcp '{"name":"sipgate-api","command":"npx","args":["-y","sipgateio-mcp"],"env":{"SIPGATE_TOKEN_ID":"your-token-id","SIPGATE_TOKEN":"your-token"}}'

Cursor

  1. 导航到 Cursor Settings > MCP
  2. 点击 + Add new Global MCP Server
  3. 添加到全局 .cursor/mcp.json 文件:
{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

Cline

添加到 cline_mcp_settings.json

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

Roo Code

通过 "Edit MCP Settings" 添加:

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

调试方式

  1. 确保环境变量 SIPGATE_TOKEN_IDSIPGATE_TOKEN 已正确设置
  2. 使用示例命令测试功能:
<use_mcp_tool>
<server_name>sipgate-api</server_name>
<tool_name>get_phone_numbers</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>
  1. 检查返回结果是否符合预期

许可证

该项目遵循 MIT 开源许可条款。