使用说明

项目简介

elevenlabs-mcp 是一个 Model Context Protocol (MCP) 服务器，旨在将 ElevenLabs 的文本转语音 API 服务以标准化的 MCP 协议形式提供给 LLM 客户端，例如 Claude Desktop。通过该服务器，LLM 可以方便地调用 ElevenLabs 的各种语音合成功能。

主要功能点

资源 (Resources) 托管: 虽然仓库描述为将ElevenLabs endpoints作为MCP资源，但根据代码分析，该项目主要侧重于将 ElevenLabs API 接口作为 工具 (Tools) 提供，而非资源。
工具 (Tools) 注册和执行: 自动解析 ElevenLabs OpenAPI 规范，将 API 接口（如文本转语音、语音克隆等）注册为 MCP 工具。LLM 客户端可以通过标准的 MCP 协议调用这些工具，实现 ElevenLabs 的功能。
动态工具发现: 服务器启动时会根据配置的 OpenAPI 规范动态加载和注册工具，方便扩展和更新支持的 ElevenLabs API 功能。
易于配置: 通过简单的 JSON 配置，即可将该 MCP 服务器集成到支持 MCP 协议的 LLM 客户端中，例如 Claude Desktop。

安装步骤

该 MCP 服务器以 npm 包的形式发布，无需克隆仓库，可以直接在支持 MCP 协议的客户端中配置使用。

服务器配置

要将 elevenlabs-mcp 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要编辑客户端的配置文件（例如 Claude Desktop 的 'claude_desktop_config.json'），并添加以下服务器配置信息。请注意，以下配置信息为 JSON 格式，您需要根据您的实际情况修改 'ELEVENLABS_API_KEY' 的值。

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "npx",
      "args": ["-y", "@angelogiacco/elevenlabs-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "YOUR_ELEVENLABS_API_KEY"
      }
    }
  }
}

配置参数说明:

server name (ElevenLabs): 服务器名称，可以自定义，用于在客户端中标识该 MCP 服务器。
command (npx): 启动服务器的命令，'npx' 用于执行 npm 包。
args (["-y", "@angelogiacco/elevenlabs-mcp-server"]): 传递给 'npx' 命令的参数。
- '-y': 'npx' 的参数，表示自动安装 '@angelogiacco/elevenlabs-mcp-server' 包（如果尚未安装）。
- '@angelogiacco/elevenlabs-mcp-server': 要执行的 npm 包名称，即 elevenlabs-mcp 服务器的 npm 包名。
env (environment variables): 环境变量配置。
- ELEVENLABS_API_KEY (YOUR_ELEVENLABS_API_KEY): 必须配置。您的 ElevenLabs API 密钥，用于服务器访问 ElevenLabs API。请将 'YOUR_ELEVENLABS_API_KEY' 替换为您实际的 API 密钥。

注意: 请务必将 'YOUR_ELEVENLABS_API_KEY' 替换为您在 ElevenLabs 官方网站申请的 API 密钥。API 密钥的安全性至关重要，请妥善保管，避免泄露。

基本使用方法

配置 MCP 客户端: 按照上述 "服务器配置" 部分的说明，将 elevenlabs-mcp 服务器配置添加到您的 MCP 客户端中。
启动 MCP 客户端: 启动配置了 elevenlabs-mcp 服务器的 MCP 客户端，客户端会自动连接到该 MCP 服务器。
在 LLM 中使用工具: 在 LLM 的提示词或指令中，可以使用 elevenlabs-mcp 服务器提供的工具。工具的名称和描述信息来源于 ElevenLabs OpenAPI 规范。您可以参考 ElevenLabs API 文档来了解可用的工具及其参数。

例如 (假设 LLM 客户端支持工具调用):

您可以指示 LLM 使用 'text-to-speech' 工具将一段文本转换为语音。具体的工具名称和参数需要参考 ElevenLabs API 规范和该 MCP 服务器暴露的工具列表。

重要提示:

该 MCP 服务器主要将 ElevenLabs API 封装为 工具 (Tools) 提供给 LLM 使用。
工具的具体名称和参数取决于 ElevenLabs OpenAPI 规范，并会在服务器启动时动态加载。
使用前请确保您已拥有有效的 ElevenLabs API 密钥，并正确配置到 'ELEVENLABS_API_KEY' 环境变量中。

关键词