GV

garan0613/voice-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

48 stars 58 forks 品質 71 トレンド 21MIT

garan0613/voice-mcp は [https://github.com/garan0613/voice-mcp.] からインポートされた MCP サーバー候補です

概要

garan0613/voice-mcp は [https://github.com/garan0613/voice-mcp.] からインポートされた MCP サーバー候補です

概要(AI 翻訳)

インラインオーディオプレーヤーとAI音声合成用のMCP(Model Context Protocol)サーバー。 あなたのAIアシスタントにカスタムクローンされたボイスを与えます!

##特徴

  • カスタムボイスクローニング* - 独自のクローンされたボイスでMiniMax TTS APIを使用する
  • 可聴周波可聴周波可聴周波プレーヤー** — 波形の視覚化の美しいWeChatスタイルのプレーヤー
  • リリースTranscript Toggle — テキストを表示/非表示
  • ̇ダークモードサポート - 自動テーマの適応
  • ⚡ Cloudflare Workers — Fast, serverless デプロイメント

デモ

speak ツールを呼び出すと、次のようになります。

  • 再生/一時ボタンを備えた洗練されたオーディオプレーヤー
  • 再生進捗を追ったアニメーション波形
  • 期間の表示
  • 拡張可能なトランスクリプト

クイックスタート

##1. リポジトリのクローン化

##2. 依存関係のインストール

##3. MiniMax API の設定

音声クローニングを有効にしてMiniMaxアカウントが必要です。

Cloudflare に秘密を追加します。

現在のMiniMax T2A認証はAPIキーのみを使用します。 グループIDは必要ありません。

##4. 展開

5. Claude.ai に接続

  1. 「設定」→「コネクタ」→「コネクターを追加」に移動**
  2. ワーカー URL を入力してください: [https://your-worker.workers.dev/mcp
  3. 寄付! speak ツールが使用可能になりました。

設定

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

🎙️ voice-mcp

An MCP (Model Context Protocol) server for AI voice synthesis with an inline audio player. Give your AI assistant a custom cloned voice!

Features

  • 🎤 Custom Voice Cloning — Use MiniMax TTS API with your own cloned voice
  • 🎵 Inline Audio Player — Beautiful WeChat-style player with waveform visualization
  • 📝 Transcript Toggle — Show/hide the spoken text
  • 🌙 Dark Mode Support — Automatic theme adaptation
  • ⚡ Cloudflare Workers — Fast, serverless deployment

Demo

When you call the speak tool, you get:

  • A sleek audio player with play/pause button
  • Animated waveform that follows playback progress
  • Duration display
  • Expandable transcript

Quick Start

1. Clone the repository

git clone https://github.com/garan0613/voice-mcp.git
cd voice-mcp

2. Install dependencies

npm install

3. Configure MiniMax API

You’ll need a MiniMax account with voice cloning enabled.

Add your secrets to Cloudflare:

npx wrangler secret put MINIMAX_API_KEY
npx wrangler secret put VOICE_ID
npx wrangler secret put BOT_NAME  # Optional, defaults to "AI"

Current MiniMax T2A authentication uses the API key only. GroupId is no longer required.

4. Deploy

npx wrangler deploy

5. Connect to Claude.ai

  1. Go to Settings → Connectors → Add Connector
  2. Enter your Worker URL: https://your-worker.workers.dev/mcp
  3. Done! The speak tool is now available.

Configuration

Variable Required Description
MINIMAX_API_KEY ✅ Your MiniMax API key
VOICE_ID ✅ The cloned voice ID
BOT_NAME ❌ Display name (default: “AI”)

API Endpoints

Endpoint Description
GET /mcp MCP server (SSE protocol)
GET /speak?text=Hello Direct audio file
GET /status Health check

How to Clone a Voice

  1. Go to MiniMax Console
  2. Navigate to Voice Cloning
  3. Upload 10-30 seconds of clear audio
  4. Wait for processing (usually a few minutes)
  5. Copy the Voice ID

Custom Deployment

Using a Custom Domain

  1. Add your domain to Cloudflare
  2. Create a DNS record pointing to your Worker
  3. Update wrangler.jsonc:
{
  "routes": [
    { "pattern": "voice.yourdomain.com/*", "zone_name": "yourdomain.com" }
  ]
}

Self-Hosting (Node.js)

The core MCP logic can be adapted for other platforms. You’ll need to:

  1. Replace createMcpHandler with a standard HTTP/SSE handler
  2. Use @modelcontextprotocol/sdk directly
  3. Handle the SSE transport yourself

Tech Stack

GitHub で README 全文を見る

インストール

npx wrangler secret put MINIMAX_API_KEY
MCP 初心者?mcpskill.org のガイドから始めましょう →