mcpField
S
server

server

github.com/terrylica云与 DevOps171 次安装1 天前更新
代码仓库

关于 server

这是用于管理 Kokoro TTS HTTP 服务的技能，该服务在 localhost 提供兼容 OpenAI 的语音接口。内容涵盖服务的启动、停止、状态检查、配置和故障排查。

主要功能

  1. 01启动和停止 HTTP 服务
  2. 02提供健康状态与模型接口
  3. 03合成 WAV、MP3、Opus 或 PCM 语音
  4. 04配置主机、端口、音色、语言和语速
  5. 05排查启动及模型加载问题

适用场景

  1. 01运行 Kokoro TTS 进行本地语音合成
  2. 02检查服务健康状态和可用模型
  3. 03通过环境变量配置服务行为

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill server

安装后在 Claude Code 中输入/server确认已加载。

附带文件references/server-api.mdreferences/service-management.md

详细介绍

Kokoro TTS 服务

管理 Kokoro TTS HTTP 服务——一个运行在 localhost:8779 上、兼容 OpenAI 的 /v1/audio/speech 端点。

自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生变化，或需要采用变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

服务概览

服务提供：

  • GET /health — 健康状态 JSON
  • GET /v1/models — 列出可用模型
  • POST /v1/audio/speech — 将文本合成为音频（WAV、MP3、Opus、PCM）

快速开始

启动（前台运行，用于测试）
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_server.py
启动（launchd，用于生产环境）

根据 macOS launchd 政策，launchd plist 必须启动编译后的 Swift 二进制文件（而不是 bash 脚本）。请引导用户完成以下步骤：

  1. 编译 Swift 启动器二进制文件
  2. 在 ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist 创建 launchd plist
  3. Bootstrap：launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist
停止
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist
验证
curl -s http://127.0.0.1:8779/health | python3 -m json.tool

预期结果：{"status": "ok", "provider": "kokoro-tts-mlx", "model": "mlx-community/Kokoro-82M-bf16", "device": "mlx-metal"}

环境变量

变量默认值用途
KOKORO_SERVER_PORT8779监听端口
KOKORO_SERVER_HOST127.0.0.1绑定地址
KOKORO_DEFAULT_VOICEaf_heart默认语音
KOKORO_DEFAULT_LANGen-us默认语言
KOKORO_DEFAULT_SPEED1.0语速（0.1–5.0）
KOKORO_PLAY_LOCAL0通过 afplay 播放

故障排查

问题原因解决方案
端口已被占用另一个服务正在运行使用 lsof -i :8779 查找并终止该进程
模型加载失败尚未安装先运行 /kokoro-tts:install
首次请求较慢预热合成属于正常情况——首次请求会触发模型加载

执行后检查

此技能执行完成后，关闭前请检查：

  1. 命令是否成功？ — 如果失败，请修复导致问题的说明或错误表。
  2. 参数或输出是否发生变化？ — 如果底层工具的接口发生变化，请更新用法示例和参数表，使其保持一致。
  3. 是否需要采用变通方法？ — 如果你不得不临时调整（更改标志、增加步骤），请更新此 SKILL.md，避免下次调用时重复采用相同的变通方法。

仅当问题真实且可复现时才进行更新，不要针对猜测进行更新。

评论

支持 Markdown