Model Context Protocol & AI Agent Skills

Scribis AI Agent Skill & MCP 指南

教您如何安裝 scribis-transcribe Skill，並在 Windows、macOS 獨立版與 Mac App Store 沙盒環境下配置 CLI、Stdio Socket 與 MCP HTTP Server Port 通訊。

psychology

1. 安裝 AI Agent Skill (scribis-transcribe)

將此 Skill 安裝至您的 AI 助手環境（如 Claude Code, Cursor, Google Antigravity, Codex CLI, Windsurf），即可讓 AI 自動調用 Scribis 進行語音轉轉錄、字幕修正與時間軸編輯。

步驟 1：下載 ZIP 壓縮套件

Download scribis.install-skill.zip from GitHub Release:

步驟 2：解壓縮至 Skill 目錄

📍 Google Antigravity IDE (全域目錄)

# Windows: %USERPROFILE%\.gemini\config\skills\scribis-transcribe
# macOS: ~/.gemini/config/skills/scribis-transcribe

📍 Claude Code / Cursor / 通用專案目錄 (.agents/skills)

# Project Workspace:
/your-project/.agents/skills/scribis-transcribe

⚙️ 或在專案 skills.json 中註冊路徑

{
  "entries": [
    { "path": "path/to/scribis-transcribe" }
  ]
}

terminal

2. 安裝與設定 Scribis CLI

Scribis CLI 提供了命令列工具 proxy 與 stdio MCP bridge Bridge 傳輸橋樑。

建置與安裝 CLI 命令

cd client/cli
npm install
node bin/scribis.js install-cli

提示：請確保 ~/.local/bin (macOS) 或 %LOCALAPPDATA%\Programs\scribis (Windows) 已加入系統 PATH 環境變數。

hub

3. 平台與通訊模式配置矩陣 (Windows / macOS / App Store)

根據您使用的作業系統與發行管道，Scribis 支援 Stdio IPC Socket 與 MCP HTTP Server 通訊通道。

適用：Windows 獨立安裝包 & macOS (DMG) 獨立版

模式 A：Stdio (IPC Socket) 模式

直接透過系統高硬體效率 IPC 通道 (Windows Named Pipe / Unix Socket) 與執行中的 Scribis Desktop 應用程式溝通。無需設定 Port。

CLI Status Check:scribis status

適用：Mac App Store 沙盒版 (App Sandbox) & 遠端代理

模式 B：MCP Server Port (HTTP JSON-RPC) 模式

🍎 Mac App Store 沙盒機制說明：因 Apple App Sandbox 禁止非特權跨進程 Unix Domain Socket 存取，Mac App Store 版本將透過開放 MCP HTTP Server Port 進行安全通訊。

啟用與使用步驟：

1. 開啟 Scribis Desktop 應用程式，進入「設定 / MCP Server」檢視當前開放的 HTTP Port (如 8890)。

2. 在命令列帶入 SCRIBIS_MCP_PORT 環境變數並加上 --mcp 標籤：

macOS / Linux:SCRIBIS_MCP_PORT=8890 scribis status --mcpWindows (PowerShell):$env:SCRIBIS_MCP_PORT="8890"; scribis status --mcp

settings_ethernet

4. MCP Host (mcp.json) 配置範例

在 Claude Code / Cursor / Windsurf 等 MCP Host 配置文件中加入 Scribis 服務：

Method A: Direct Stdio Bridge (Windows / macOS DMG)

{
  "mcpServers": {
    "scribis": {
      "command": "node",
      "args": ["/path/to/client/bridge.js"]
    }
  }
}

Method B: MCP HTTP Mode (Mac App Store Sandbox)

{
  "mcpServers": {
    "scribis": {
      "command": "scribis",
      "args": ["transcribe", "--mcp"],
      "env": {
        "SCRIBIS_MCP_PORT": "8890"
      }
    }
  }
}