13 · MCP 集成

Trae (AI)  ←→  MCP Server  ←→  数据库 / API / 文件系统

┌──────────────────────────────────────┐
│          Trae AI 引擎                 │
│   (Chat / Builder / SOLO)            │
├──────────────────────────────────────┤
│          MCP Client 层               │
│   负责发现、路由、安全隔离            │
├──────────────────────────────────────┤
│  ┌────────┐  ┌────────┐  ┌────────┐ │
│  │ MCP    │  │ MCP    │  │ MCP    │ │
│  │ Server │  │ Server │  │ Server │ │
│  │ (DB)   │  │ (API)  │  │ (File) │ │
│  └────────┘  └────────┘  └────────┘ │
│  ┌────────┐  ┌────────┐             │
│  │ MCP    │  │ MCP    │             │
│  │ Server │  │ Server │             │
│  │ (Git)  │  │ (云服务)│             │
│  └────────┘  └────────┘             │
├──────────────────────────────────────┤
│        外部系统（你的基础设施）       │
│  PostgreSQL  Supabase  GitHub  文件系统│
└──────────────────────────────────────┘

{
  "servers": {
    "my-database": {
      "type": "stdio",
      "command": "node",
      "args": ["path/to/mcp-server.js"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
      }
    }
  }
}

{
  "servers": {
    "<server-name>": {
      "type": "stdio",
      "command": "<可执行文件>",
      "args": ["<参数>"],
      "env": {
        "<环境变量名>": "<环境变量值>"
      }
    }
  }
}

npm install -g @anthropic/mcp-postgres
# 或者用 npx 临时运行
npx @anthropic/mcp-postgres --help

{
  "servers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://username:password@localhost:5432/myapp"
      }
    }
  }
}

┌─ MCP Servers ──────────────────┐
│ ● postgres         已连接      │
│   Tools: query, schema, migrate│
└────────────────────────────────┘

连接一下 PostgreSQL，列出 myapp 数据库的所有表。

{
  "servers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

{
  "servers": {
    "postgres-readonly": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://readonly_user:password@read-replica:5432/myapp"
      }
    }
  }
}

{
  "servers": {
    "pg": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://analyzer:password@localhost:5432/ecommerce"
      }
    }
  }
}

连接我们的电商数据库，分析所有表的 schema，找出索引缺失、外键漏配、或数据类型不合理的地方。生成一份优化报告。

Table: orders
├─ id (UUID, PK)
├─ user_id (UUID, NO INDEX → 发现问题)
├─ total (DECIMAL(10,2))
└─ status (VARCHAR(20), NO INDEX → 发现问题)

Table: order_items
├─ id (UUID, PK)
├─ order_id (UUID, FK → 但 orders 表未定义外键约束)
├─ product_id (UUID, FK → 但 products 表未定义外键约束)
└─ quantity (INTEGER)

┌─────────── ecommerce 数据库优化报告 ──────────────────┐
│                                                       │
│ 🔴 发现问题 3 个：                                     │
│                                                       │
│ 1. orders.user_id 缺少索引                             │
│    影响：按用户查询订单时全表扫描                       │
│    建议：CREATE INDEX idx_orders_user_id ON ...        │
│                                                       │
│ 2. orders.status 缺少索引                              │
│    影响：按状态过滤订单时全表扫描                       │
│    建议：CREATE INDEX idx_orders_status ON ...         │
│                                                       │
│ 3. order_items 缺少外键约束                            │
│    影响：可能产生孤儿数据                             │
│    建议：ALTER TABLE order_items ADD FOREIGN KEY ...   │
│                                                       │
│ 🟢 设计合理的地方：                                    │
│ - users 表有 created_at 索引                          │
│ - 金额字段使用 DECIMAL 而非 FLOAT（正确）             │
│ ───────────────────────────────────────────────────── │
│ 优化后预期：                                          │
│ - 用户订单查询：从 ~300ms 降至 ~5ms                   │
│ - 状态过滤查询：从 ~200ms 降至 ~2ms                   │
│ └─────────────────────────────────────────────────────┘

接受所有建议，生成迁移 SQL 脚本，写入到 migrations/optimize_001.sql 文件。

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
const server = new Server(
  { name: "hello-world", version: "1.0.0" },
  { capabilities: { tools: {} } }
);
 
server.setRequestHandler("tools/list", async () => ({
  tools: [{
    name: "greet",
    description: "向用户打招呼",
    inputSchema: {
      type: "object",
      properties: {
        name: { type: "string" }
      }
    }
  }]
}));
 
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "greet") {
    const name = request.params.arguments?.name || "World";
    return {
      content: [{ type: "text", text: `Hello, ${name}!` }]
    };
  }
  throw new Error("Unknown tool");
});
 
const transport = new StdioServerTransport();
await server.connect(transport);