Kudosity MCP

官方

使用Kudosity API构建,发送短信和彩信。访问开发者文档、API参考和实时测试工具,发送消息、管理联系人列表、配置Webhook等。

你可以用 Kudosity MCP 做什么?

  • 发现可用的消息API — 让您的AI使用 list-specs 列出所有Kudosity API(SMS、RCS、WhatsApp)。
  • 检查API端点和参数 — 让助手使用 list-endpointsget-endpoint 探索任何服务的路径、方法和支持的参数。
  • 获取请求和响应模式 — 通过 get-request-bodyget-response-schema 获取端点的精确请求体格式或响应结构。
  • 生成可直接运行的代码片段 — 使用 get-code-snippet 生成带有正确认证的curl、JavaScript或Python示例。
  • 执行实时API调用 — 使用 execute-request 直接从聊天发送真实短信或测试任何Kudosity端点。

文档

Kudosity 模型上下文协议 (MCP) 服务器允许 AI 驱动的编辑器(如 Cursor 和 Windsurf)和助手(如 Claude Desktop)直接探索和执行 Kudosity API。借助 MCP,您的 AI 可以搜索 API 规范、生成代码片段并运行实时请求——所有这些都无需离开您的开发环境。

什么是 MCP?

模型上下文协议 (MCP) 是一项开放标准,允许 AI 应用程序安全地访问外部数据源和工具。Kudosity MCP 服务器为 AI 代理提供:

  • 直接 API 访问 Kudosity 功能——发送消息、更新联系人列表等。
  • 文档搜索——让您的 AI 智能搜索 API 规范和教程,提供精准答案。
  • 来自 Kudosity 账户的实时数据——直接从聊天中查询和执行实时操作。
  • 代码生成 用于 Kudosity 集成
  • 实时 API 执行——超越静态示例,运行真实请求
  • 始终保持最新——由 Swagger API 源定义驱动

MCP 服务器功能

Kudosity MCP 服务器提供用于 API 发现、文档、代码生成和实时执行的全面工具:

🔍 API 发现与探索

  • list-specs — 发现可用的消息 API(SMS、RCS、WhatsApp 等)
  • list-endpoints — 列出服务的所有 API 路径和方法
  • get-endpoint — 检查任何路径支持的方法和参数
  • search-specs — 跨规范搜索关键字或模式

📋 API 架构与文档

  • get-request-body — 检索任何端点的请求体架构
  • get-response-schema — 查看特定端点和状态码的响应架构
  • list-security-schemes — 检查身份验证方法和要求
  • search-documentation — 搜索 API 文档内容

⚡ 代码生成

  • get-code-snippet — 生成 curl、JavaScript、Python 等可直接运行的示例
  • 自动提供正确的身份验证和参数

🚀 实时 API 执行

  • execute-request — 使用 HAR 格式运行真实 API 调用
  • 发送测试短信
  • 使用实时凭据验证任何 Kudosity 端点
  • 返回实际响应和错误

可用 API

MCP 服务器提供对这些 Kudosity API 的访问:

  • Transmit Message API — v2 消息服务,支持 SMS、RCS、MMS、WhatsApp 和 webhooks
  • Transmit SMS API — 功能齐全的 SMS,具有高级联系人列表、关键字和报告功能

Kudosity MCP 服务器设置

Kudosity 在 https://developers.kudosity.com/mcp 托管一个远程 MCP 服务器。配置您的 AI 开发工具以连接到此服务器。

身份验证配置

对于需要身份验证的 API,您需要配置 API 凭据。根据端点的不同,方法有所区别:

  • api.transmitsms.com(v1 端点)基本身份验证,使用 Base64 编码的 API Key 和 Secret
  • api.transmitmessage.com(v2 端点)API Key 身份验证,在 x-api-key 头中使用您的密钥

对于 v1 端点 (api.transmitsms.com) - 基本身份验证:

  1. 获取凭据 从 Kudosity 仪表板 → 开发者 → API 设置
  2. 组合为API_KEY:API_SECRET
  3. Base64 编码
    • 终端:echo -n "API_KEY:API_SECRET" | base64
    • 浏览器控制台:btoa("API_KEY:API_SECRET")
    • 在线工具:base64encode.org

对于 v2 端点 (api.transmitmessage.com) - API Key 身份验证:

直接在 x-api-key 头中使用您的 API Key(无需 Base64 编码)。

对于 v1 端点 (api.transmitsms.com) - 添加到 claude_desktop_config.json

JSON

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "Authorization: Basic ${KUDOSITY_AUTH_HEADER}"
      ],
      "env": {
        "KUDOSITY_AUTH_HEADER": "YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

重要:保存配置文件后重启您的 AI 工具。

您也可以使用以下命令为此项目安装 Claude MCP 集成:

Bash

claude mcp add kudosity --scope project -- npx mcp-remote https://developers.kudosity.com/mcp

测试您的 MCP 设置

配置完成后,您可以测试 MCP 服务器连接:

  1. 重启您的 AI 工具(Claude Desktop、Cursor 等)
  2. 与 AI 助手开始新对话
  3. 询问关于 Kudosity 的问题 — 尝试以下问题:
    • “Kudosity 提供哪些 API?”
    • “给我展示一个发送 SMS 的示例”
    • “创建一个 curl 命令,通过 Kudosity 发送我的第一条 SMS”
    • “如何开始使用 Kudosity 发送 SMS?”

如果成功,AI 将直接从您的账户和文档中提取 Kudosity API 详细信息和示例代码进行回复。

大约 2 个月前更新


复制页面