内容
[](https://github.com/sandraschi/fastmcp) [](https://github.com/astral-sh/ruff) [](https://biomejs.dev/) [](https://github.com/casey/just)
<div align="center">
# Kyutai-MCP
<p align="center">
<a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a>
<a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
<a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a>
<a href="https://biomejs.dev"><img src="https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat-square&logo=biome&logoColor=white" alt="Biome"></a>
<a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a>
</p>
> 📖 **[安装指南](INSTALL.md)** — 快速开始，手动设置和故障排除
### 在本地运行 **Kyutai Moshi**。通过 **玻璃仪表盘** 进行驱动，并通过 **FastMCP** 将相同的表面插入到你的 **代理栈** 中。
[快速开始](#快速开始) [网络用户界面](#网络仪表盘) [技术文档](docs/)
FastMCP **3.1+** 标准输入输出 + HTTP `/mcp` 网页 **10924** / **10925** MCP HTTP **10926**
</div>
---
## 快速开始
```powershell
git clone https://github.com/sandraschi/kyutai-mcp
cd kyutai-mcp
just
```
这将打开一个交互式仪表盘，显示所有可用的命令。运行 `just bootstrap` 以安装依赖，然后运行 `just serve` 或 `just dev` 以启动。
### 手动设置
如果你没有安装 `just`：
## 网络仪表盘
标准页面：**首页**，**操作**，**工具**（操作 + MCP 目录），**应用程序**（Glama / 清单），**Moshi**（和 `/talk`），**状态**，**聊天**，**日志**，**设置**，**帮助**。
应用内 **帮助** 页面是完整的运算符手册（路由，Glom-On，API，故障排除）。
---
## MCP 服务器（标准输入输出）
```powershell
uv run python -m kyutai_mcp
```
将此作为标准输入输出 MCP 服务器连接到 Cursor/你的客户端。参见 [docs/MCP.md](docs/MCP.md)。
---
## 技术文档
| 文档 | 内容 |
|-----|----------|
| [docs/WEBAPP.md](docs/WEBAPP.md) | 端口，路由，堆栈，构建 |
| [docs/MCP.md](docs/MCP.md) | 工具，传输，发现 |
| [docs/MOSHI_SERVICE.md](docs/MOSHI_SERVICE.md) | 上游 Moshi 进程，HTTP 探测 |
| [docs/GLOM.md](docs/GLOM.md) | 本地 LLM 附件（Ollama / LM Studio） |
| [docs/VOICE_WORKFLOWS.md](docs/VOICE_WORKFLOWS.md) | 分阶段语音编排，提示，示例，代理样板 |
---
## 相关：speech-mcp（云语音）
**[speech-mcp](https://github.com/sandraschi/speech-mcp)** 是该项目的云对应版本。Kyutai-mcp 在本地 GPU 上运行 Moshi，而 speech-mcp 连接到云语音 API。
| | kyutai-mcp（此仓库） | speech-mcp |
|---|---|---|
| 引擎 | Moshi（Kyutai，开源） | Gemini Live，Gemini TTS，Hume，ElevenLabs |
| 运行于 | 本地 GPU（RTX 4090，CUDA） | 云 API |
| 隐私 | 完全离线 | 云 |
| 延迟 | 低（本地） | 亚秒级（Gemini Live） |
| 语音质量 | 良好 | 非常好至最高 |
| 语音克隆 | 否 | 是（ElevenLabs IVC） |
| 多语言 | 有限 | 100+ 种语言（Gemini TTS） |
| 成本 | 免费（硬件后） | API 使用成本 |
在需要隐私或离线操作时使用 kyutai-mcp。在优先考虑语音质量，多语言覆盖或语音克隆时使用 speech-mcp。两者都暴露相同的混合 MCP 工具模式，可以在不同端口上同时运行。
---
该项目遵循 **SOTA 14.1** 高保真代理编排的工业标准：
- **Python（核心）**：[Ruff](https://astral.sh/ruff) 用于代码检查和格式化。核心处理程序中严禁使用 `print` 语句（`T201`）。
- **Web 应用程序（UI）**：[Biome](https://biomejs.dev/) 用于毫秒级代码检查。严格执行 `noConsoleLog`。
- **协议遵从性**：强化 `stdout/stderr` 隔离，以确保抗崩溃的 JSON-RPC 通信。
- **自动化**：[Justfile](./justfile) 提供了所有舰队操作（`just lint`，`just fix`，`just dev`）的配方。
- **安全**：通过 `bandit` 和 `safety` 进行自动审计。
## 许可证
参见仓库中的 `LICENSE`（如果存在）；Kyutai/Moshi 上游有其自己的许可证，请参阅 [Kyutai Moshi](https://github.com/kyutai-labs/moshi) 以获取模型和服务器条款。
