MimikaStudio MCP 服务端实现
使用说明
- 项目简介
- 该仓库实现了一个基于 MCP（Model Context Protocol）的服务器端，能够以 JSON-RPC 规范与 MCP 客户端（如 Claude Code CLI、Codex 等）交互，提供对语音合成、语音克隆、模型管理、Audiobook 生成等后端功能的访问。
- MCP 服务器作为前端客户端和后端核心服务之间的桥梁，将请求转发到本地 FastAPI 后端的 REST 端点，并将结果以 MCP Tool 的 JSON-RPC 格式返回给客户端，同时暴露一个用于诊断和仪表板的工具清单。
- 主要功能点
- MCP 工具注册与调用：提供超过 50 个 MCP 工具，涵盖 TTS 生成、声音管理、Audiobook 任务、系统信息、LLM 配置、IPA、样本与音频管理等，统一以工具名、参数和返回内容进行管理。
- JSON-RPC 协议支持：实现 initialize、tools/list、tools/call 等核心 MCP 请求的处理，返回标准的 jsonrpc 2.0 响应格式。
- 与后端 REST 的桥接：通过内部调用后端 API（如 /api/kokoro/generate、/api/qwen3/generate 等）实现实际业务逻辑，并将结果封装为 MCP 兼容的输出。
- 简易的管理与监控：提供一个内置的 MCP Dashboard 视图，展示工具和 REST API 的状态、端口、以及服务器健康状况等信息。
- 安装步骤
- 依赖与环境在仓库根部提供的脚本与说明中给出，包含 Python、所需的 Python 包、以及可选的桌面/网页 UI 支持等。
- 基本依赖安装后，启动 MCP 服务器的常用方式通常为：
- 启动 MCP 服务：执行命令 python bin/mimikactl mcp start（默认为监听端口 8010，后端 API 为 http://localhost:8000）。
- 运行后端 API（FastAPI）需要先完成后端的安装与启动，具体请参考仓库的安装指导。
- 服务器配置（JSON 配置模板，非代码示例）
{
"server_name": "mimikastudio-mcp",
"command": "python",
"args": ["bin/mimikactl", "mcp", "start", "--host", "127.0.0.1", "--port", "8010"],
"env": {
"MIMIKASTUDIO_BACKEND_URL": "http://localhost:8000",
"LOG_LEVEL": "INFO"
},
"description": "MCP 服务器配置：启动 MimikaStudio 的 MCP 服务，监听 8010 端口，与本地 FastAPI 后端 API 交互。"
}
注释说明：
- server_name：MCP 服务器在集成环境中的唯一名称，应与服务器程序中的常量一致（mimikastudio-mcp）。
- command 与 args：启动 MCP 服务的实际命令和参数，建议使用与仓库提供的 mimikactl 脚本相结合的启动方式，以确保 MCP 端口与路径配置正确。
- env：可选的环境变量，用于指向后端服务地址、日志级别等，确保 MCP 与后端之间的通信地址正确。
- 该配置仅用于 MCP 客户端的连接信息；实际后端服务（语音合成、模型管理等）仍由后端 REST API 提供。
- 基本使用方法
- 客户端接入
- 通过 MCP 客户端（如 Claude Code CLI、Codex 等）连接到 MCP 服务器，使用 initialize 进行握手，调用 tools/list 获取工具列表，调用 tools/call 执行具体工具。
- MCP 服务监控
- MCP dashboard 将显示工具分组、工具参数、以及 REST 端点的状态，便于运营与调试。
- 集成步骤简要
- 启动后端并确保 http://localhost:8000 提供服务。
- 启动 MCP 服务器，监听端口 8010。
- 使用 MCP 客户端向 8010 发送 initialize、tools/list、tools/call 请求，获取工具列表并执行需要的操作。
- 常见问题
- MCP 服务无法启动时，请检查日志输出，确认后端 API 是否可用（8000 端口是否在运行）。
- 确认网络连通性和端口防火墙设置，确保 MCP 客户端能够访问 8010 端口。
- 客户端接入