メインコンテンツまでスキップ

上級: ローカル stdio

通常は会社ホスティングMCPのURLとアカウントログインを使用します。 このページは、開発者がローカルMCPプロセスを直接実行する場合の別の方法です。 APIキーとパッケージのインストールが必要です。

インストール​

Node.js 22以降とKitschから提供されたパッケージアーカイブを用意してください。 公開npmパッケージやダウンロードURLを推測しないでください。以下のBashコマンドでは、 KITSCH_PACKAGE_TGZに提供されたファイルの絶対パスを設定します。

npm install --prefix ./kitsch-mcp --omit=dev --ignore-scripts "$KITSCH_PACKAGE_TGZ"

プロジェクトと音声フォルダの外にある個人用設定ディレクトリにmcp.envを作成し、 自分で発行した有効なワークスペースAPIキーと音声専用フォルダの絶対パスを設定します。 自分だけが読めるように保護し、リポジトリやチャットで共有しないでください。

KITSCH_API_KEY=<YOUR_WORKSPACE_API_KEY>
KITSCH_AUDIO_DIR=/absolute/path/to/kitsch-audio

クライアント設定​

既存のmcpServersに以下を追加します。すべてのパスを実際の絶対パスに置き換え、 ほかのサーバー設定は保持してください。WindowsのJSONパスでもC:/Users/...形式を 使用できます。クライアントの設定形式が異なる場合は、同じcommandとargsを その形式で登録してください。

{
  "mcpServers": {
    "kitsch-local": {
      "command": "node",
      "args": [
        "--env-file=/absolute/path/to/mcp.env",
        "/absolute/path/to/kitsch-mcp/node_modules/@kitschlabs/agent-audio/dist/stdio.js"
      ]
    }
  }
}

接続を再読み込みし、list_voicesで確認します。合成・文字起こしはAPIキーの ワークスペースに課金されるため、ユーザーが依頼した範囲でのみテストしてください。

ローカルツール​

ツール入力結果
list_voicesなし利用できる音声とvoice_id
synthesize_speechvoice_id、text。任意でoutput_format: mp3|wav保存されたaudio_pathとMIMEタイプ
transcribe_audio音声フォルダ内のaudio_path。任意でlanguage、prompt完成した文字起こし

ローカルツールにホスティングMCPのoperation_idを渡さないでください。 文字起こしは最大100 MiBで、絶対パスまたは音声フォルダからの相対パスを指定します。 任意項目が未指定の場合は、空文字列ではなくフィールドを省略してください。

合成は完成したファイルを返します。return_audio: trueを指定すると、2 MiB以下の 結果にはオーディオcontentも含まれます。ローカルファイルは自動削除されないため、 ユーザーが整理してください。リアルタイムのマイク認識と再生は別の連携が必要です。 失敗した有料リクエストを自動再試行しないでください。