TRAE 添加 MCP Server 完整指南：从配置到实战

hi10611

3人浏览 · 2026-09-13 09:35:55

hi10611 · 2026-09-13 09:35:55 发布

1. 什么是 MCP Server

MCP（Model Context Protocol）是 Anthropic 提出的开放协议，用于统一大模型与外部工具、数据源之间的交互方式。MCP Server 则是实现该协议的服务端组件，它把文件系统、数据库、API 等能力封装成标准接口，供 AI 编程助手调用。

TRAE 作为新一代 AI IDE，原生支持 MCP 协议。通过添加 MCP Server，你可以让 TRAE 直接操作本地文件、查询数据库、调用第三方 API，从而大幅扩展 AI 助手的实际能力边界。

2. 准备工作

在开始配置之前，请确保满足以下条件：

TRAE 版本不低于 1.0.0，建议使用最新稳定版。
已安装 Node.js 18+ 或 Python 3.9+（取决于你选择的 MCP Server 类型）。
准备一个可用的 MCP Server 地址或本地启动脚本。

3. 在 TRAE 中添加 MCP Server

TRAE 提供了图形化配置界面，操作非常直观。下面按步骤说明。

3.1 打开 MCP 配置面板

在 TRAE 中，点击左侧边栏的「MCP」图标，或者通过快捷键 Ctrl+Shift+M（Windows/Linux）或 Cmd+Shift+M（macOS）打开 MCP 管理面板。

3.2 添加新的 MCP Server

在 MCP 面板中，点击「添加 MCP Server」按钮，你会看到两种添加方式：

标准模式：通过表单填写服务器名称、类型和地址。
JSON 模式：直接编辑 JSON 配置，适合批量添加或精确控制参数。

3.3 配置示例：添加文件系统 MCP Server

下面以官方 filesystem MCP Server 为例，演示完整配置过程。

在 JSON 模式下，输入以下配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents/projects"
      ]
    }
  }
}

配置完成后，点击「保存」，TRAE 会自动启动该 MCP Server。如果配置正确，你会看到状态变为「已连接」。

4. 实战：连接 GitHub MCP Server

下面演示如何连接 GitHub MCP Server，让 TRAE 具备仓库管理和 Issue 操作能力。

4.1 获取 GitHub Token

首先，在 GitHub 设置中生成一个 Personal Access Token，需要勾选 repo 和 read:org 权限。

4.2 配置 GitHub MCP Server

在 TRAE 的 MCP 面板中，添加以下配置：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

4.3 验证连接

保存配置后，在 TRAE 的对话窗口中输入以下指令测试：

请列出我最近创建的 5 个仓库

如果配置成功，TRAE 会调用 GitHub MCP Server 并返回真实数据。

5. 自定义 MCP Server：用 Python 实现

除了使用现成的 MCP Server，你还可以编写自己的 MCP Server。下面给出一个基于 Python 的示例。

5.1 安装依赖

pip install mcp fastmcp

5.2 编写 MCP Server 代码

from fastmcp import FastMCP

mcp = FastMCP("MyTimeServer")

@mcp.tool()
def get_current_time(timezone: str = "Asia/Shanghai") -> str:
    """获取指定时区的当前时间"""
    from datetime import datetime
    from zoneinfo import ZoneInfo
    now = datetime.now(ZoneInfo(timezone))
    return now.strftime("%Y-%m-%d %H:%M:%S %Z")

if __name__ == "__main__":
    mcp.run()

5.3 在 TRAE 中注册自定义 Server

将上述代码保存为 time_server.py，然后在 TRAE 的 MCP 配置中添加：

{
  "mcpServers": {
    "time-server": {
      "command": "python",
      "args": [
        "/path/to/time_server.py"
      ]
    }
  }
}

6. 常见问题排查

在添加 MCP Server 的过程中，可能会遇到一些问题。下面列出常见场景及解决方案。

6.1 连接失败

如果 MCP Server 状态显示「连接失败」，请依次检查：

命令路径是否正确，npx 或 python 是否在 PATH 中。
端口是否被占用，尤其是使用 SSE 或 HTTP 传输时。
查看 TRAE 的日志输出，定位具体报错信息。

6.2 权限不足

当 MCP Server 需要访问文件或网络时，请确认运行 TRAE 的用户具备相应权限。例如，文件系统 Server 需要读写目标目录的权限。

6.3 环境变量未生效

如果 MCP Server 依赖环境变量（如 API Key），请确认变量名拼写正确，且值没有多余空格。修改配置后需要重启 TRAE 才能生效。

7. 进阶技巧

掌握以下技巧，可以让 MCP Server 的使用更加高效。

7.1 使用 SSE 远程 Server

除了本地进程，TRAE 也支持连接远程 MCP Server。配置方式如下：

{
  "mcpServers": {
    "remote-server": {
      "url": "https://example.com/mcp/sse"
    }
  }
}

7.2 组合多个 Server

你可以在一个配置文件中同时注册多个 MCP Server，TRAE 会自动管理它们的生命周期。例如：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

8. 总结

本文详细介绍了在 TRAE 中添加 MCP Server 的完整流程，包括图形化配置、JSON 配置、连接 GitHub 服务、自定义 Python Server 以及常见问题排查。通过合理配置 MCP Server，你可以让 TRAE 的 AI 助手真正融入日常开发工作流，实现代码、数据、工具的无缝协作。

建议从文件系统 Server 开始尝试，逐步扩展到数据库、API 等更复杂的场景，你会发现 AI 编程的潜力远超想象。