Kudosity MCP
官方使用Kudosity API构建,发送短信和彩信。访问开发者文档、API参考和实时测试工具,发送消息、管理联系人列表、配置Webhook等。
你可以用 Kudosity MCP 做什么?
- 发现可用的消息API — 让您的AI使用
list-specs列出所有Kudosity API(SMS、RCS、WhatsApp)。 - 检查API端点和参数 — 让助手使用
list-endpoints和get-endpoint探索任何服务的路径、方法和支持的参数。 - 获取请求和响应模式 — 通过
get-request-body和get-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) - 基本身份验证:
- 获取凭据 从 Kudosity 仪表板 → 开发者 → API 设置
- 组合为:
API_KEY:API_SECRET - 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 服务器连接:
- 重启您的 AI 工具(Claude Desktop、Cursor 等)
- 与 AI 助手开始新对话
- 询问关于 Kudosity 的问题 — 尝试以下问题:
- “Kudosity 提供哪些 API?”
- “给我展示一个发送 SMS 的示例”
- “创建一个 curl 命令,通过 Kudosity 发送我的第一条 SMS”
- “如何开始使用 Kudosity 发送 SMS?”
如果成功,AI 将直接从您的账户和文档中提取 Kudosity API 详细信息和示例代码进行回复。
大约 2 个月前更新
复制页面