内容
# svmmon-mcp
使用您的 [Svmmon](https://app.svmmonapp.com) 账户，从 Claude（以及任何 MCP 客户端）生成 TikTok 幻灯片。
这是一个轻薄的本地 **stdio MCP 服务器**，它封装了 Svmmon 的公共 `/api/v1` REST API。安装它，粘贴您的密钥，并要求 Claude 用纯语言制作幻灯片。它没有添加任何业务逻辑 — 每个工具都与真正的 Svmmon 端点一对一映射。
> **需要成长计划或以上。** API 被限制在成长+账户。安装始终有效；工具返回一个干净的“需要成长+”消息，直到您粘贴有效的付费密钥。
---
## 快速入门
### 1. 获取您的密钥
app.svmmonapp.com → **设置 → API 密钥 → Svmmon API → 生成密钥** （成长计划或以上）。它类似于 `svm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`。
> 将此密钥视为密码。如果它曾经被暴露，请立即在 **设置 → API 密钥** 中撤销它 — MCP 无法为您撤销它。
### 2. 添加服务器
**Claude 桌面版** — 编辑 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"svmmon": {
"command": "npx",
"args": ["-y", "svmmon-mcp"],
"env": { "SVMMON_API_KEY": "svm_您的密钥_在此" }
}
}
}
```
**Claude 代码：**
```bash
claude mcp add svmmon -e SVMMON_API_KEY=svm_您的密钥_在此 -- npx -y svmmon-mcp
```
### 3. 请求
> *为我的 Marcus 配置文件生成 5 个钩子，并从最佳的一个中创建一个幻灯片。*
---
## 工具列表
| 工具 | 功能 |
|---|---|
| `get_usage` | 等级，幻灯片使用/上限，重置日期，每个账户的 TikTok 消息槽。 |
| `list_profiles` | 您的配置文件，包含 `id`、`name`、`niche`、`ready`、`missing`、`tiktok_linked`。只有 `ready` 配置文件才能生成。 |
| `list_presets` | 幻灯片生成的有效 `preset_id` 值。 |
| `generate_hooks` | 配置文件的得分钩子候选。 如果达到 AI 信用上限，可能会返回少于请求的钩子。 |
| `generate_slideshow` | 生成一个幻灯片（消耗一个您的每月上限 — **不幂等**）。返回 24 小时下载链接；可选地发送到 TikTok/Telegram。 |
| `list_slideshows` | 您最近的幻灯片。 |
| `get_slideshow` | 通过 ID 获取幻灯片 + 新鲜的 1 小时下载链接。 |
---
## 配置
| 环境变量 | 必需 | 默认值 | 备注 |
|---|---|---|---|
| `SVMMON_API_KEY` | 是 | — | 您的 `svm_` 密钥。仅从环境中读取 — 绝不通过命令行传递。 |
| `SVMMON_BASE_URL` | 否 | `https://app.svmmonapp.com` | 仅在自托管/测试时覆盖。 |
---
## 故障排除
- **"密钥缺失、无效或已撤销" (401)** — 将 `SVMMON_API_KEY` 设置为来自设置 → API 密钥的当前密钥。
- **"需要成长计划或以上" (403)** — 在 app.svmmonapp.com/subscribe 升级。
- **"达到使用上限" (402)** — 您达到了每月幻灯片或 AI 信用上限。运行 `get_usage`。
- **"速率限制" (429)** — 如果显示建议时间，请等待；否则，这是每日 AI 限制，在 UTC 时间凌晨重置。消息告诉您是哪一个。
---
## 版本控制
`1.x` 以 Svmmon `/api/v1` 合同为目标。破坏性 API 更改（`/api/v2`）将作为 `2.x` 发布。
## 安全
此软件包处理实时、成本承载凭证。它仅从环境中读取密钥，绝不记录它，绝不将其放入进程参数中，也绝不在错误中回显它。它对成本燃烧调用不执行自动重试。如发现安全问题，请报告至 support@svmmonapp.com。
## 许可证
MIT
