Jarvis MCP

🚀 Jarvis MCP

讓你的人工智能鮮活起來 —— 在瀏覽器中即刻與智能助手對話。兼容Claude Desktop、OpenCode和其他支持MCP的人工智能工具。

✅ 無需額外軟件、服務或API密鑰 —— 只需在瀏覽器中打開網頁應用並授予麥克風訪問權限。

✨ 主要特性

• 🎙️ 語音對話：與人工智能助手進行自然的語音交流。
• 🌍 支持30多種語言：具備多語言語音識別能力。
• 📱 遠程訪問：在計算機上運行人工智能時，可通過手機或平板電腦進行訪問。
• ⚙️ 智能控制：擁有可摺疊設置、常開模式和自定義語音等功能。
• ⏱️ 動態超時：根據響應長度智能設置等待時間。
• 🧰 無需額外軟件：完全在瀏覽器中運行，無需額外安裝或API密鑰。
• 🔌 可選的Whisper流式傳輸：連接到本地Whisper服務器以實現低延遲轉錄。

📦 安裝指南

🚀 一鍵式安裝

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項目和瀏覽器。
• 一鍵安裝，並與最新的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. 將其集成到你的人工智能工具中：使用上述安裝命令為Claude Desktop、OpenCode或Claude Code註冊MCP服務器。
2. 開啟語音交互：從你的助手調用converse工具；Jarvis MCP會在後臺自動啟動，必要時會打開https://localhost:5114。
3. 允許麥克風訪問：首次出現瀏覽器提示時批准。
4. 自然對話：每次回覆都繼續使用converse；Jarvis MCP會處理其餘操作。

語音命令在人工智能聊天中的使用

使用converse工具開始對話：
- converse("Hello! How can I help you today?", timeout: 35)

📚 詳細文檔

瀏覽器界面

網頁界面提供以下功能：

• 語音設置（點擊⚙️展開）
  • 語言選擇（30多種選項）
  • 語音選擇
  • 語音速度控制
  • 麥克風常開模式
  • 靜音檢測靈敏度和超時設置（用於Whisper流式傳輸）
• 智能控制
  • 在人工智能語音時暫停（防止回聲）
  • 用戶說話時停止人工智能（實現自然對話）
• 移動設備友好：可在手機和平板電腦上使用。

遠程訪問

可從網絡中的任何設備進行訪問：

1. 查找計算機的IP地址：在Mac/Linux系統中使用ifconfig | grep inet，在Windows系統中使用ipconfig。
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指向你自己的地址。
• 當轉錄正在進行時，用戶界面會繼續錄製，並忽略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（目前僅測試過此瀏覽器）
• 麥克風訪問權限
• 可選：本地Whisper服務器（如pfrankov/whisper-server），如果你想通過MCP_VOICE_STT_MODE=whisper實現流式語音識別。

故障排除

• 移動設備出現證書警告？ 點擊“高級” → “繼續訪問該網站”以接受自簽名證書。
• 麥克風無法工作？ 確保使用的是HTTPS（而非HTTP），檢查瀏覽器權限，嘗試刷新頁面。
• 人工智能不響應語音？ 確保正在使用converse工具（而非僅使用speak），檢查超時設置是否正確。

開發

npm install
npm run build
npm run dev     # 監聽模式
npm run start   # 運行服務器

📄 許可證

本項目採用MIT許可證。