Trae MCP 集成实战：扩展 AI 的工具能力

开篇：让 Trae 不只是写代码

如果 Trae 能直接帮你查数据库、操作 GitHub、读写文件系统，开发效率会提升多少？

通过 MCP 集成，Trae 可以连接各种外部工具和服务，让 AI 从”只会写代码”变成”能操作整个开发工具链”。这篇文章不讲 MCP 协议原理，只聚焦一件事：怎么在 Trae 里配好 MCP Server，让它跑起来。

Trae MCP 支持概览

能力	支持状态	说明
stdio 传输	✅	通过标准输入输出与 Server 通信
SSE 传输	✅	通过 Server-Sent Events 远程连接
Streamable HTTP	✅	新一代 HTTP 流式传输
Tools / Resources	✅	AI 自动选择执行工具、读取资源
多 Server 并行	✅	同时连接多个 MCP Server
可视化管理面板	✅	不用手动找配置文件路径

Trae 相比 Cursor、Windsurf 的一个明显优势：它有 UI 面板管理 MCP，还有社区 Server 一键安装。

配置步骤：Settings > MCP Settings

1. 打开 Trae，点击左下角齿轮图标（Settings）
2. 找到 "MCP Settings"（或 Cmd+Shift+P 搜索 "MCP"）
3. 点击 "Add MCP Server"
4. 选择"手动配置"或"从社区导入"
5. 填写 JSON 配置，保存后 Trae 自动连接

连接成功看到绿灯，红灯说明配置有问题。

JSON 配置格式

配置文件位置：

# macOS
~/Library/Application Support/Trae/User/globalStorage/mcp.json
# Windows
%APPDATA%\Trae\User\globalStorage\mcp.json

三种传输类型的配置格式：

// stdio 类型（最常用）
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@some-org/mcp-server"],
      "env": { "API_KEY": "your-api-key" }
    }
  }
}

// SSE / Streamable HTTP 类型（远程服务）
{
  "mcpServers": {
    "remote-server": {
      "url": "https://your-server.com/sse",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

SSE 和 Streamable HTTP 配置格式相同，Trae 会根据服务端响应自动判断传输方式。

实战：配置 GitHub MCP Server

先去 GitHub Settings > Developer settings > Personal access tokens 生成一个 Token，勾选 repo、issues、pull_requests 权限。

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

配置成功后，AI 自动获得这些能力：

工具	功能	示例
`create_issue`	创建 Issue	”帮我创建一个 bug Issue”
`list_issues`	列出 Issue	”看看未关闭的 Issue”
`create_pull_request`	创建 PR	”提一个 PR 到 main”
`search_repositories`	搜索仓库	”搜 MCP 相关的仓库”
`get_file_contents`	读取文件	”看看 README 写了什么”

验证：在 Chat 中输入”帮我列出 my-org/my-repo 最近的 5 个 Issue”，能返回结果就说明配好了。

实战：配置数据库 MCP Server

// PostgreSQL
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-postgres",
        "postgresql://username:password@localhost:5432/mydb"
      ]
    }
  }
}

// MySQL
{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your-password",
        "MYSQL_DATABASE": "mydb"
      }
    }
  }
}

安全提醒：给 MCP 用一个只读数据库用户，别拿 root 连生产库。

CREATE USER 'mcp_readonly'@'localhost' IDENTIFIED BY 'safe-password';
GRANT SELECT ON mydb.* TO 'mcp_readonly'@'localhost';

实战：配置文件系统 MCP

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

路径参数是白名单——AI 只能访问你指定的目录。别把 / 加进去。

Agent 自动选择执行 MCP 工具

你不需要手动指定用哪个工具，AI 会根据意图自动选择。假设你同时配了 GitHub、PostgreSQL 和文件系统三个 Server：

你：查一下数据库里 users 表最近注册的 10 个用户，
    然后在 GitHub 上创建一个 Issue 记录用户增长情况

AI 自动执行：
1. [调用 postgres.query] SELECT * FROM users ORDER BY created_at DESC LIMIT 10
2. 分析查询结果
3. [调用 github.create_issue] 创建 Issue，内容基于查询结果生成

一句话，AI 自动串联了两个不同的 MCP Server。

在 Chat 和 Builder 中调用 MCP

Chat 模式：最自然的方式。用自然语言描述需求，AI 在回答过程中自动调用工具。每次调用会显示一个工具卡片，可以展开看请求和响应。

Builder 模式：MCP 融入构建流程。比如你说”基于数据库的 products 表结构，生成 CRUD 页面”，Builder 会先调用数据库 MCP 查表结构，再基于结果生成类型定义、API 路由和前端组件。

trae-community 社区 MCP 集合

在 MCP Settings 面板点击 “Discover” 标签，或者访问 trae-community GitHub 仓库。

Server	功能	安装方式
server-github	GitHub 操作	一键安装
server-postgres	PostgreSQL 查询	一键安装
server-filesystem	文件系统读写	一键安装
server-slack	Slack 消息	一键安装
server-fetch	HTTP 请求	一键安装
server-puppeteer	浏览器自动化	一键安装

点 “Install”，填环境变量，保存，Server 自动启动。不需要手动编辑 JSON。

调试与排错

Server 状态红灯

node --version   # 需要 v18+
npx --version    # 确认 npx 可用
npx -y @modelcontextprotocol/server-github  # 手动跑看报什么错

环境变量不生效

Trae 启动 MCP Server 时不会继承终端环境变量。即使你在 .zshrc 里设了 Token，JSON 配置里也必须显式写上。

工具列表为空

Server 绿灯但 AI 不调用工具？在 MCP Settings 面板点击对应 Server，查看 Tools 标签页。如果为空，点 Refresh。仍然为空就 npm cache clean --force 后重连。

常见错误速查

错误	原因	解决
`spawn npx ENOENT`	找不到 npx	安装 Node.js 或检查 PATH
`Connection refused`	Server 未启动	检查命令和参数
`401 Unauthorized`	Token 无效	重新生成 Token
`ETIMEOUT`	网络超时	检查网络或配置代理

查看详细日志：View > Output（Cmd+Shift+U），下拉选择 MCP 输出通道。

工具的价值不在于它有多少功能，而在于这些功能能不能在你需要的时候，自然地出现在你手边。MCP 让 AI 的能力边界，变成了你工具链的边界。

加载中...