mux

Mux TypeScript MCP サーバー

インストール

直接実行

npx を使って MCP サーバーを直接実行できます。

export MUX_TOKEN_ID="my token id"
export MUX_TOKEN_SECRET="my secret"
export MUX_WEBHOOK_SECRET="My Webhook Secret"
export MUX_SIGNING_KEY="My Jwt Signing Key"
export MUX_PRIVATE_KEY="My Jwt Private Key"
export MUX_AUTHORIZATION_TOKEN="my authorization token"
npx -y @mux/mcp@latest

MCP クライアント経由

既存のクライアントの一部はmodelcontextprotocol.ioに掲載されています。すでに クライアントをお持ちの場合は、MCP サーバーのインストール方法について、そのドキュメントをご確認ください。

設定 JSON を使用するクライアントの場合、次のような設定になります。

{
  "mcpServers": {
    "mux": {
      "command": "npx",
      "args": ["-y", "@mux/mcp"],
      "env": {
        "MUX_TOKEN_ID": "my token id",
        "MUX_TOKEN_SECRET": "my secret",
        "MUX_WEBHOOK_SECRET": "My Webhook Secret",
        "MUX_SIGNING_KEY": "My Jwt Signing Key",
        "MUX_PRIVATE_KEY": "My Jwt Private Key",
        "MUX_AUTHORIZATION_TOKEN": "my authorization token"
      }
    }
  }
}

Cursor

Cursor をお使いの場合は、以下のボタンから MCP サーバーをインストールできます。環境変数は、 Cursor の mcp.json で設定する必要があります。このファイルは Cursor Settings > Tools & MCP > New MCP Server にあります。

VS Code

MCP をお使いの場合は、以下のリンクをクリックして MCP サーバーをインストールできます。環境変数は、 VS Code の mcp.json で設定する必要があります。このファイルは Command Palette > MCP: Open User Configuration から開けます。

VS Code を開く

Claude Code

Claude Code をお使いの場合は、ターミナルで以下のコマンドを実行して MCP サーバーをインストールできます。環境変数は、 ホームディレクトリにある Claude Code の .claude.json で設定する必要があります。

claude mcp add mux_mcp_api --env MUX_TOKEN_ID="my token id" MUX_TOKEN_SECRET="my secret" MUX_WEBHOOK_SECRET="My Webhook Secret" MUX_SIGNING_KEY="My Jwt Signing Key" MUX_PRIVATE_KEY="My Jwt Private Key" MUX_AUTHORIZATION_TOKEN="my authorization token" -- npx -y @mux/mcp

コードモード

この MCP サーバーは、「Code Mode」ツールスキームに基づいて構築されています。この MCP サーバーでは、 エージェントが TypeScript SDK を使ってコードを記述し、そのコードが隔離されたサンドボックスで実行されます。これを実現するため、サーバーはエージェントに次の 2 つのツールを提供します。

• 1 つ目はドキュメント検索ツールです。API／SDK に関するドキュメントを幅広く検索するために使用できます。

• 2 つ目はコードツールです。エージェントは TypeScript SDK を使ってコードを記述できます。 コードはウェブやファイルシステムにアクセスできないサンドボックス環境で実行されます。その後、 コードが返す、または出力する内容は、ツール呼び出しの結果としてエージェントに返されます。

このスキームを使うことで、エージェントは非常に複雑なタスクを決定論的かつ再現可能な形で実行できます。

実行モード

デフォルトでは（--code-execution-mode=local）、コードは MCP サーバーマシン上の 隔離された Deno サンドボックスで実行されます。--code-execution-mode=remote を設定する（または MCP_SERVER_CODE_EXECUTION_MODE 環境変数を設定する）と、代わりにコードがリモートのコード サンドボックスサービスに送信されます。設定には次の項目を使用します。

• --code-sandbox-url / CODE_SANDBOX_URL：サンドボックスサービスの URL。リモートモードでは必須です。
• --code-sandbox-api-key / CODE_SANDBOX_API_KEY：Bearer トークンとして送信される、サンドボックスサービスの API キー。リモートモードでは必須です。

ローカルモードでは Deno のもとでコードが実行されます。Deno は、パッケージがオプションの deno 依存関係を通じてインストールします。バイナリのダウンロードがブロックされている場合、npm install --omit=optional を使用する場合、 または Alpine のように Deno が npm ビルドを提供していないプラットフォームでは、Deno 2.9 以降の実行可能ファイルを DENO_PATH に設定してください。同じ変数は、後述の mcp-code-runner にも適用されます。デスクトップバンドル（.mcpb）には Deno が 含まれていません。その設定でも同じ目的で DENO_PATH を指定できます。

呼び出し元が送信できるリクエストヘッダー

HTTP トランスポートでは、x-stainless-mcp-client-envs を使って呼び出し元がクライアント環境の値（認証情報など）を指定でき、x-stainless-mcp-client-permissions を使ってコードツールの権限を調整できます。どちらもデフォルトで受け付けられるため、サーバーの前段にある信頼できるプロキシがこれらの値を利用できます。呼び出し元にどちらも許可しない公開環境では、--no-client-header-overrides を指定してサーバーを起動してください（または streamableHTTPApp に組み込む場合は、mcpOptions で clientHeaderOverrides: false を渡してください）。

サーバー外でのコード実行

このパッケージは、呼び出し元のコードを独自の VM で実行するサンドボックスサービス向けに、mcp-code-runner バイナリもインストールします。ローカル実行モードと同じ Deno ワーカーで 1 件のリクエストを実行します。{"code": ..., "client_opts": ...} を JSON として標準入力またはファイル引数から渡すと、{is_error, result, log_lines, err_lines} の JSON 行を 1 行、標準出力に書き込み、Deno 自身の出力は標準エラーに書き込みます。ネットワーク許可の対象はローカル実行モードと同様に、SDK が呼び出すホスト（クライアントのベース URL と、一部のエンドポイントが使用するメディアホスト）です。

リモート実行

--transport=http を指定してクライアントを起動すると、Streamable HTTP トランスポートを使用するリモートサーバーとしてサーバーが起動します。--port 設定で実行するポートを選択でき、--socket 設定を使うと Unix ソケットで実行できます。

Authorization ヘッダーでは、Basic または Bearer スキームを使って認証情報を指定できます。

さらに、次のヘッダーでも認証情報を指定できます。

ヘッダー	対応するクライアントオプション	セキュリティスキーム
x-mux-token-id	tokenId	accessToken
x-mux-token-secret	tokenSecret	accessToken
x-mux-authorization-token	authorizationToken	authorizationToken

サーバーが http://localhost:3000 でホストされている場合、このサーバー用の設定 JSON は次のようになります。

{
  "mcpServers": {
    "mux": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Basic <auth value>"
      }
    }
  }
}