Jarvis MCP

🚀 Jarvis MCP

AIを生き生きと使えるようにしましょう。ブラウザ上ですぐにAIアシスタントと会話できます。Claude Desktop、OpenCode、その他のMCP対応AIツールと互換性があります。

✅ 追加のソフトウェア、サービス、APIキーは不要です。ブラウザでウェブアプリを開き、マイクのアクセスを許可するだけです。

✨ 主な機能

🎙️ 音声会話 - AIアシスタントと自然に話せます
🌍 30種類以上の言語 - 複数言語での音声認識が可能です
📱 リモートアクセス - AIはコンピュータで動作させながら、スマートフォンやタブレットから利用できます
⚙️ スマートコントロール - 折りたたみ可能な設定、常時オンモード、カスタムボイスがあります
⏱️ 動的タイムアウト - 応答の長さに基づいた賢い待機時間を設定できます
🧰 追加ソフト不要 - すべてブラウザ内で動作します。追加のインストールやAPIキーは不要です
🔌 オプションのWhisperストリーミング - 低遅延の文字起こしを行うために、ローカルのWhisperサーバーに接続できます

📦 インストール

🚀 1コマンドでのセットアップ

Claude Desktop:

npx @shantur/jarvis-mcp --install-claude-config
# Claude Desktopを再起動すると使えます！

OpenCode (現在のプロジェクト内):

npx @shantur/jarvis-mcp --install-opencode-config --local
npx @shantur/jarvis-mcp --install-opencode-plugin --local
# OpenCodeを起動し、会話ツールを使います

Claude Code CLI:

npx @shantur/jarvis-mcp --install-claude-code-config --local
# Claude Code CLIを起動し、音声ツールを使います

🤖 OpenCodeプラグインをインストールする理由

• ツールが実行中やタスクが進行中でも、音声メッセージをOpenCodeにストリーミングできます。
• 保留中のJarvis MCP会話を自動転送するので、ユーザーのリクエストを逃すことがありません。
• 完全にローカルで動作します。外部サービスは不要で、OpenCodeプロジェクトとブラウザだけです。
• 1コマンドでインストールでき、最新のJarvis MCP機能と同期します。

📦 手動インストール

NPMから:

npm install -g @shantur/jarvis-mcp
jarvis-mcp

ソースから:

git clone <repository-url>
cd jarvis-mcp
npm install && npm run build && npm start

💻 使用例

基本的な使用法

1. AIツールに接続する – 上記のインストールコマンドをClaude Desktop、OpenCode、またはClaude Codeに使用して、MCPサーバーを登録します。
2. 音声会話を開始する – アシスタントからconverseツールを呼び出します。Jarvis MCPは自動的にバックグラウンドで起動し、必要に応じてhttps://localhost:5114を開きます。
3. マイクのアクセスを許可する – 初めて表示されるブラウザのプロンプトを承認します。
4. 自然に話す – すべての返信にconverseを使い続けます。Jarvis MCPが残りの処理を行います。

AIチャットでの音声コマンド

会話を開始するには、converseツールを使用します。
- converse("こんにちは！今日は何をお手伝いできますか？", timeout: 35)

📚 ドキュメント

ブラウザインターフェイス

ウェブインターフェイスは以下を提供します。

• 音声設定 (⚙️をクリックして展開)
  • 言語選択 (30種類以上のオプション)
  • ボイス選択
  • 話速コントロール
  • マイク常時オンモード
  • 無音検出の感度とタイムアウト (Whisperストリーミング用)
• スマートコントロール
  • AIの発話中に一時停止 (エコーを防止)
  • ユーザーが話すとAIを停止 (自然な会話)
• モバイル対応 - スマートフォンやタブレットでも動作します

リモートアクセス

ネットワーク内の任意のデバイスからアクセスできます。

1. コンピュータのIPアドレスを見つけます。ifconfig | grep inet (Mac/Linux) または ipconfig (Windows)
2. スマートフォンやブラウザでhttps://YOUR_IP:5114にアクセスします。
3. セキュリティ警告を受け入れます (自己署名証明書)
4. マイクのパーミッションを許可します

机から離れていても会話を続けるのに最適です！

設定

環境変数

export MCP_VOICE_AUTO_OPEN=false  # ブラウザの自動開啟を無効にする
export MCP_VOICE_HTTPS_PORT=5114  # HTTPSポートを変更する
export MCP_VOICE_STT_MODE=whisper  # ウェブアプリをWhisperストリーミングに切り替える
export MCP_VOICE_WHISPER_URL=http://localhost:12017/v1/audio/transcriptions  # Whisperエンドポイント (完全なパス)
export MCP_VOICE_WHISPER_TOKEN=your_token  # WhisperサーバーのオプションのBearer認証

Whisperストリーミングモード

• Whisperモードでは、ブラウザ内で生のPCMを録音し、16 kHzのモノラルWAVに変換し、組み込みのHTTPSプロキシを介してストリーミングするので、ローカルのwhisper-serverはOpenAI互換のリクエストを受け取ります。
• デフォルトでは、標準のwhisper-serverエンドポイントhttp://localhost:12017/v1/audio/transcriptionsにプロキシします。別のホスト/ポートで実行している場合は、MCP_VOICE_WHISPER_URLを自分のホスト/ポートに設定してください。
• UIは文字起こし中も録音を続け、Whisperの非言語タグ (例: [BLANK_AUDIO], (typing)) を無視するので、実際の音声のみがキューに入ります。
• 有効にするには、
  1. ローカルでWhisperサーバーを実行します (例: pfrankov/whisper-serverのwhisper-server)。
  2. 上記の環境変数を設定します (MCP_VOICE_STT_MODE=whisperと完全なMCP_VOICE_WHISPER_URL)。
  3. jarvis-mcpを再起動し、ブラウザを強制更新 (キャッシュを空にして再読み込み) して、ストリーミングバンドルを読み込みます。
  4. 音声ステータス (voice_status()ツール) が、Whisperまたはブラウザの音声認識がアクティブかどうかを報告します。

ポート

• HTTPS: 5114 (マイクアクセスに必要)
• HTTP: 5113 (ローカルアクセスのみ)

必要条件

• Node.js 18以上
• Google Chrome (現時点でテスト済みのブラウザのみ)
• マイクアクセス
• オプション: MCP_VOICE_STT_MODE=whisperを使用してストリーミング音声認識を行う場合は、ローカルのWhisperサーバー (例: pfrankov/whisper-server)

トラブルシューティング

モバイルで証明書警告が表示される場合

• 「詳細」→「サイトに進む」をタップして、自己署名証明書を受け入れます。

マイクが機能しない場合

• HTTPS (HTTPではない) を使用していることを確認します。
• ブラウザのパーミッションを確認します。
• ページを更新してみます。

AIが音声に反応しない場合

• converseツールを使用していることを確認します (speakだけではない)。
• タイムアウトが適切に計算されていることを確認します。

開発

npm install
npm run build
npm run dev     # ウォッチモード
npm run start   # サーバーを実行

📄 ライセンス

MIT