bd-jojo-remote-build-mcp 0.1.3

MCP Server for JoJo Remote Build in BD

如何在 Trae 中配置 jojo-remote-build-server

这是一个基于 MCP (Model Context Protocol) 的服务器，旨在为 Trae IDE 提供 Aweme 项目的自动化远程构建能力。它封装了复杂的 jojo 命令行操作，提供了智能的路径修复、错误分析和环境配置功能。

功能特性 (Available Tools)

该 MCP Server 提供了以下两个核心工具：

1. init_remote_build_environment (初始化远程环境)

用于一键配置远程构建所需的各项环境依赖。

• 功能:
  • 自动执行 mbox jojo install --remote (含自动重试机制)。
  • 自动执行 mbox jojo recodesign 配置签名 (支持指定 device_udid)。
  • 自动开启 mbox jojo remote_mode --build-in-shell。
  • 包含智能容错处理（如忽略非致命的下载错误）。
• 参数:
  • project_path (可选): 项目根目录，默认自动识别。
  • device_udid (可选): 指定用于签名的设备 UDID（推荐提供，以避免交互式选择）。

2. run_aweme_remote_build (执行远程构建)

用于执行 Aweme 项目的完整远程构建流程。

• 功能:
  • 执行标准的 jojo build 命令 (arm64, Debug 模式)。
  • 支持构建前清理 (clean)。
  • 智能日志分析: 自动提取编译错误和链接错误，过滤冗余日志，直接展示关键问题。
  • 路径自适应: 自动纠正用户输入的非标准路径（如自动寻找 Aweme/Aweme 子目录）。
• 参数:
  • project_path (可选): 项目根目录。
  • scheme (可选): 构建 Scheme，默认为 AwemeInhouseDebug。
  • clean (可选): 是否先执行 clean 操作，默认为 False。

---

1. 准备环境

确保已安装依赖。在终端中运行：

# 使用 uv 创建虚拟环境 (指定 Python 3.12)
uv venv .remote_build_mcp_venv --python 3.12

# 激活虚拟环境
source .remote_build_mcp_venv/bin/activate

# 安装依赖
uv pip install -r requirements.txt

2. 配置 Trae MCP Server

1. 打开 Trae 设置 (Settings)。
2. 导航到 Features -> MCP Servers。
3. 点击 Add MCP Server (或者编辑配置文件)。
4. 填写以下信息：

• Type: stdio
• Name: jojo-remote-build (或你喜欢的名字)
• Command: /Users/bytedance/Desktop/jojoRemoteBuildMCP/.venv/bin/python3
  • 注意：请使用虚拟环境中的 Python 绝对路径，确保能找到 mcp 库。
• Arguments:
  • /Users/bytedance/Desktop/jojoRemoteBuildMCP/mcp_server.py

JSON 配置示例 (如果是直接编辑 JSON)

{
  "mcpServers": {
    "jojo-remote-build": {
      "command": "/Users/bytedance/Desktop/jojoRemoteBuildMCP/.venv/bin/python3",
      "args": [
        "/Users/bytedance/Desktop/jojoRemoteBuildMCP/mcp_server.py"
      ]
    }
  }
}

3. 验证

配置完成后，Trae 应该会显示该 Server 为 "Connected" 状态。 你可以在 Chat 中尝试询问："执行 Aweme 远程构建"，或者手动调用 run_aweme_remote_build 工具。