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 服务基于“代码模式”工具方案构建。在此 MCP 服务中， 你的 Agent 将针对 TypeScript SDK 编写代码，然后在隔离的沙箱中执行。为此，服务会向你的 Agent 提供两个工具：

• 第一个工具是文档搜索工具，可用于通用查询 API/SDK 的相关文档。

• 第二个工具是代码工具，Agent 可以在其中针对 TypeScript SDK 编写代码。 代码将在无法访问 Web 或文件系统的沙箱环境中执行。随后， 代码返回或打印的任何内容都会作为工具调用的结果返回给 Agent。

采用此方案后，Agent 能够以确定且可重复的方式执行非常复杂的任务。

执行模式

默认情况下（--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：沙箱服务的 API 密钥， 将作为 Bearer 令牌发送。远程模式下必需。

本地模式会在 Deno 下运行代码，软件包会通过其可选的 deno 依赖项自行安装 Deno。如果无法安装（例如二进制文件下载受阻、运行 npm install --omit=optional， 或者平台上的 Deno 未提供 npm 构建版本，例如 Alpine），请将 DENO_PATH 设置为 Deno 2.9 或 更高版本的可执行文件。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）。

在服务器外运行代码

此软件包还会安装一个 mcp-code-runner 可执行文件，供在自有 VM 中执行调用方代码的沙箱服务使用。它通过与本地执行模式相同的 Deno worker 处理单个请求：将 {"code": ..., "client_opts": ...} 作为 JSON 输入到 stdin，或作为文件参数传入；它会向 stdout 写入一行 {is_error, result, log_lines, err_lines} JSON，并将 Deno 自身的输出写入 stderr。网络授权范围为 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>"
      }
    }
  }
}