Sipgate API MCP Server

Sipgate API MCP 服务

免责声明：这是一个非官方集成，与 sipgate GmbH 无关联，也未获得其官方维护或认可。这是一个使用 sipgate 公共 API 的社区项目。

提供 sipgate API 访问能力的 MCP 服务，使 AI 助手能够使用 sipgate 服务，包括短信、通话和账户管理。

前置条件

1. 一个 sipgate 账户（https://www.sipgate.de/）
2. sipgate 个人访问令牌凭据：
   • 登录 sipgate 账户
   • 前往“Settings” > “Personal Access Tokens”
   • 创建新令牌
   • 记下 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"
      }
    }
  }
}

如需查找 claude_desktop_config.json 文件，请打开 Claude 应用并前往 Settings > Advanced > Open config file。

VS Code

在 VS Code 中使用以下命令安装 Sipgate API MCP 服务：

# 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

如需将此服务添加到 Cursor IDE：

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 Server 设置将内容添加到 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

在 Roo Code 设置中通过“Edit MCP Settings”访问 MCP 设置：

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

可用工具

账户管理

• get_account_info：获取 sipgate 账户信息
• get_user_info：获取已认证用户的信息

通信

• send_sms：发送短信
• initiate_call：发起电话呼叫

电话系统

• get_phone_numbers：列出关联的电话号码
• get_devices：列出关联的设备
• get_call_history：查看通话记录

如需查看详细的工具文档和参数，请使用 AI 助手的帮助命令。

可用资源

• sipgate://account - 账户信息
• sipgate://numbers - 电话号码
• sipgate://history - 通话记录
• sipgate://devices - 设备

使用示例

<use_mcp_tool>
<server_name>sipgate-api</server_name>
<tool_name>get_phone_numbers</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

故障排除

常见问题：

1. 身份验证错误：

   • 确认 Token ID 和 Token 正确无误
   • 检查令牌是否具有所需权限

2. 安装问题：

   • 确保已安装 Node.js
   • 尝试在安装前运行 npx clear-npx-cache

3. 服务连接：

   • 检查互联网连接
   • 确认已在 MCP 设置中启用该服务

如需更多帮助，请在 GitHub 上提交问题，并附上：

• 平台和环境详细信息
• 错误消息
• 复现步骤

开发

欢迎贡献！

许可证

MIT